For Developers
HTTP API
Generate UUIDs straight from your terminal or app — no key, no sign-up. Responses are
JSON by default; send Accept: text/plain
for newline-delimited output that's easy to pipe.
Endpoints
| Method & path | Description |
|---|---|
| GET /api/uuid | A UUID (v4 by default), or use the query parameters below. |
| GET /api/uuid/v4 | Alias for ?version=4. |
| GET /api/uuid/v7 | Alias for ?version=7. |
Query parameters
| Parameter | Values | Default |
|---|---|---|
| version | 1, 4, 7, nil | 4 |
| count | 1–1000 | 1 |
| format | lowercase, uppercase, braces, hyphenless | lowercase |
Invalid parameters return 400 with a JSON
{"error": "…"} explaining the allowed values.
Examples
# One v4 UUID
curl https://getuuid.sh/api/uuid
# → {"version":"4","format":"lowercase","uuid":"…"}
# Five v7 UUIDs
curl 'https://getuuid.sh/api/uuid?version=7&count=5'
# Aliases
curl https://getuuid.sh/api/uuid/v4
curl https://getuuid.sh/api/uuid/v7
# Plain text, 100 uppercase UUIDs
curl -H 'Accept: text/plain' 'https://getuuid.sh/api/uuid?count=100&format=uppercase'Responses
Single (count=1)
{
"version": "4",
"format": "lowercase",
"uuid": "…"
}Multiple (count > 1)
{
"version": "7",
"format": "lowercase",
"count": 5,
"uuids": ["…", "…"]
}