Endpoints
One endpoint for a single UUID, one for a batch.
GET /v1/uuid
Returns a single UUID.
Query parameters
| Param | Type | Default | Description |
|---|---|---|---|
version | int | 4 | UUID version: 4 random, 7 sortable |
{
"uuid": "9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d",
"version": 4,
"generated_at": "2026-05-30T12:00:00Z"
}GET /v1/uuid/batch
Returns many UUIDs in one request.
Query parameters
| Param | Type | Default | Description |
|---|---|---|---|
count | int | 1 | How many to return (1–1000) |
version | int | 4 | UUID version: 4 or 7 |
{
"uuids": ["…", "…"],
"count": 2,
"version": 4,
"generated_at": "2026-05-30T12:00:00Z"
}Rate limit headers
Every response includes:
| Header | Description |
|---|---|
X-RateLimit-Limit | Your per-minute request cap |
X-RateLimit-Remaining | Requests left in the current minute |
X-RateLimit-Reset | Unix seconds until the window resets |
X-Quota-Limit | Your monthly UUID quota |
X-Quota-Remaining | UUIDs left this month |