Developer UUID tools

UUID API

Generate UUIDs over HTTP for scripts, tests, fixtures, and development workflows. The API returns plain text by default and JSON when requested.

Endpoint table

Available endpoints: /api/uuid/v4, /api/uuid/v4/[count], /api/uuid/v7, /api/uuid/v7/[count], /api/guid, /api/guid/[count], /api/nil, and /api/nil/[count].

Bulk endpoints accept counts from 1 to 1000. There is no authentication requirement in this phase. Rate limiting may be added later; do not depend on unlimited production traffic.

cURL examples

Plain text is the default response format.

Plain text UUID v4

curl https://uuid-tools.dev/api/uuid/v4
curl https://uuid-tools.dev/api/uuid/v7/5

JSON response

curl -H "Accept: application/json" https://uuid-tools.dev/api/guid/3

JavaScript fetch examples

Use the Accept header when you want structured JSON instead of newline-delimited text.

Fetch UUIDs as JSON

const response = await fetch("/api/uuid/v7/3", {
  headers: { Accept: "application/json" },
});

const data = await response.json();
console.log(data.values);

Response examples

Plain text responses contain one UUID or newline-separated UUIDs. JSON responses include type, count, and values.

Plain text

123e4567-e89b-42d3-a456-426614174000
123e4567-e89b-42d3-a456-426614174001

JSON

{
  "type": "uuid-v7",
  "count": 2,
  "values": [
    "0190fd9b-8248-7a61-9e65-8f4f0a3b9d0d",
    "0190fd9b-8248-7a61-9e65-8f4f0a3b9d0e"
  ]
}

Error response examples

Invalid counts return HTTP 400 with a clear error message. Use an integer from 1 to 1000 for bulk endpoints.

Invalid count

Invalid count. Use an integer from 1 to 1000.

FAQ

Does the UUID API require authentication?+

No. The Phase 3 API endpoints are public and do not require authentication.

What response format does the API return?+

Plain text by default. Send Accept: application/json to receive a JSON response.

What is the bulk API limit?+

Bulk endpoints accept counts from 1 to 1000.

UUID generatorGenerate UUIDs in the browser.UUID v4 generatorCreate random UUIDs.UUID v7 generatorCreate ordered UUIDs.GUID generatorGenerate GUIDs.Node UUID generatorUse UUIDs in Node scripts.