Overview

A fast, free, public UUID Generator REST API that returns clean JSON over HTTPS, supporting v1, v3, v4, v5, v6, and time-ordered v7 (with guid as a v4 alias).

Generate bulk UUIDs (up to 200 per call) via simple GET endpoints, use namespace/name hashing for v3/v5 (dns/url), and optional output formatting (uppercase/braced).

No auth, sensible rate limits, and instant integration for backends, scripts, CI/CD pipelines, and static sites.

Base URL

https://toolkitvault.com/api/uuid-generator

Content-Type

application/json

Auth

Public (rate-limited)

Supported Versions

• v1, v3, v4, v5, v6, v7
• guid → alias of v4
• v2 → 501 Not Implemented (DCE Security UUIDs are not supported)

Endpoints

1. Generate with query params

GET /api/uuid-generator/{version}

Query params

• count | n — integer, number of UUIDs (default 1, min 1, hard max 200)
• namespace — for v3/v5 only: dns (default) | url
• name — for v3/v5 only: string used as the name input
• format — default | uppercase | braced | braced-uppercase

Examples

GET /api/uuid-generator/v7

GET /api/uuid-generator/v4?count=10

GET /api/uuid-generator/v5?name=my-domain.com&namespace=dns

2. Generate with path param

GET /api/uuid-generator/{version}/{count}

• Same as above, with count in the path
• name, namespace, format still apply for v3/v5 and formatting

Examples

GET /api/uuid-generator/v4/20

GET /api/uuid-generator/v3/5?name=https://example.com&namespace=url

Responses

200 OK

{
  "version": "v4",
  "count": 10,
  "maxPerCall": 200,
  "uuids": ["6b8f8b8c-7f1a-4f4e-9d2e-1a3d9f8d2c01"]
}

400 Bad Request

{
  "error": true,
  "url": "https://toolkitvault.com/api/uuid-generator/v0",
  "statusCode": 400,
  "statusMessage": "Invalid version. Use v1|v2|v3|v4|v5|v6|v7|guid",
  "message": "Invalid version. Use v1|v2|v3|v4|v5|v6|v7|guid"
}

429 Too Many Requests

{
  "error": true,
  "url": "https://toolkitvault.com/api/uuid-generator/v4",
  "statusCode": 429,
  "statusMessage": "Too Many Requests",
  "message": "Too Many Requests"
}

501 Not Implemented (v2)

{
  "error": true,
  "url": "https://toolkitvault.com/api/uuid-generator/v2",
  "statusCode": 501,
  "statusMessage": "UUID v2 (DCE Security) not supported. Use v1/v6 or v4/v7.",
  "message": "UUID v2 (DCE Security) not supported. Use v1/v6 or v4/v7."
}

Examples

# Single v7
curl -s https://toolkitvault.com/api/uuid-generator/v7

# 20 v4 via path
curl -s https://toolkitvault.com/api/uuid-generator/v4/20

# v5 with DNS namespace and name
curl -s "https://toolkitvault.com/api/uuid-generator/v5?name=my-domain.com&namespace=dns"

TypeScript Interface

export type UuidResponse = {
  version: string
  count: number
  maxPerCall: number
  uuids: string[]
}