Skip to main content

API Reference

Complete reference for all UUIDify API endpoints.

Base URL​

https://api.uuidify.io

Endpoints​

Generate UUID v1​

Time-based UUID with MAC address component.

GET /v1

Example Request:

curl https://api.uuidify.io/v1

Example Response:

{
  "uuid": "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
  "version": "v1",
  "timestamp": "2025-11-19T18:31:38.123Z"
}

Generate UUID v4​

Random UUID (most commonly used).

GET /v4

Example Request:

curl https://api.uuidify.io/v4

Example Response:

{
  "uuid": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
  "version": "v4",
  "timestamp": "2025-11-19T18:31:38.123Z"
}

Generate UUID v6​

Reordered time-based UUID (sortable).

GET /v6

Example Request:

curl https://api.uuidify.io/v6

Example Response:

{
  "uuid": "1d19dad6-ba7b-6810-80b4-00c04fd430c8",
  "version": "v6",
  "timestamp": "2025-11-19T18:31:38.123Z"
}

Generate UUID v7​

Unix timestamp-based UUID (recommended for databases).

GET /v7

Example Request:

curl https://api.uuidify.io/v7

Example Response:

{
  "uuid": "018c3f5c-7f3a-7000-8000-0123456789ab",
  "version": "v7",
  "timestamp": "2025-11-19T18:31:38.123Z"
}

Response Fields​

All endpoints return a JSON object with the following fields:

FieldTypeDescription
uuidstringThe generated UUID in standard format
versionstringThe UUID version (v1, v4, v6, or v7)
timestampstringISO 8601 timestamp of generation

Rate Limiting​

UUIDify currently does not enforce rate limits for public usage. However, we recommend:

  • Implementing client-side caching when appropriate
  • Using bulk generation for high-volume needs
  • Contacting us for enterprise requirements

Error Responses​

In case of errors, the API returns appropriate HTTP status codes:

Status CodeDescription
200Success
400Bad Request (invalid parameters)
429Too Many Requests (rate limit exceeded)
500Internal Server Error

Example Error Response:

{
  "error": "Invalid UUID version",
  "message": "Supported versions: v1, v4, v6, v7"
}

Using SDKs​

For easier integration, use our official SDKs:

Go SDK​

import "github.com/ilkereroglu/uuidify-go"

client := uuidify.NewClient()
uuid, err := client.GenerateV4()

Python SDK​

from uuidify import Client

client = Client()
uuid = client.generate_v4()

Support​