Base URL
https://createuuid.com/api
Endpoints
| Endpoint |
Version |
Description |
GET /api/v1 | v1 | Timestamp-based UUID |
GET /api/v3 | v3 | Name-based (MD5) — requires namespace + name |
GET /api/v4 | v4 | Random UUID |
GET /api/v5 | v5 | Name-based (SHA-1) — requires namespace + name |
GET /api/v6 | v6 | Reordered timestamp (sortable) |
GET /api/v7 | v7 | Unix epoch timestamp (sortable) |
Query Parameters
| Parameter |
Type |
Default |
Description |
count | integer | 1 | Number of UUIDs to generate (max 1000) |
namespace | string | — | Required for v3/v5. Use: dns, url, oid, x500, or a custom UUID |
name | string | — | Required for v3/v5. The name to hash |
Response Format
{
"version": "v4",
"count": 1,
"uuids": [
"550e8400-e29b-41d4-a716-446655440000"
]
}
Examples
Generate a single UUID v4
curl https://createuuid.com/api/v4
Generate 10 UUID v7s
curl "https://createuuid.com/api/v7?count=10"
Generate a UUID v5 (name-based)
curl "https://createuuid.com/api/v5?namespace=dns&name=example.com"
Generate a UUID v3 (MD5-based)
curl "https://createuuid.com/api/v3?namespace=url&name=https://example.com"
Generate UUID v6 (sortable timestamp)
curl https://createuuid.com/api/v6
Generate 100 UUID v1s
curl "https://createuuid.com/api/v1?count=100"
JavaScript (fetch)
const response = await fetch('https://createuuid.com/api/v4?count=5');
const data = await response.json();
console.log(data.uuids);
Python
import requests
r = requests.get('https://createuuid.com/api/v4', params={'count': 5})
print(r.json()['uuids'])
Rate Limits
The API is free and has no hard rate limits, but please be reasonable. If you need to generate millions of UUIDs, consider using a client-side library instead.
Error Responses
// Missing required parameter
{
"error": "Missing required parameter: name"
}
// Invalid namespace
{
"error": "Invalid namespace. Use: dns, url, oid, x500, or a valid UUID"
}