UUID

Generate UUIDs and ULIDs, or decode an existing one to inspect its version, variant, and embedded timestamp.

POST /api/uuid

Parameters

Field	Type	Required	Description
action	string	Yes	generate or decode
format	string	No	v4, v7, or ulid. Used with generate. Defaults to v4
value	string	No	UUID or ULID to decode. Required when action is decode

Response

Field	Type	Description
value	string	Generated UUID/ULID or the decoded input
format	string	Format type
decoded	object	Present when action is decode
decoded.version	integer	UUID version
decoded.variant	string	UUID variant
decoded.timestamp	string	Embedded timestamp (v7 / ULID only)
decoded.is_ulid	boolean	Whether the value is a ULID

Examples

Generate a v4 UUID

curl -X POST https://morso.dev/api/uuid \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"action": "generate", "format": "v4"}'

{
  "value": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
  "format": "v4"
}

Generate a ULID

curl -X POST https://morso.dev/api/uuid \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"action": "generate", "format": "ulid"}'

{
  "value": "01HYX3KPZQ8RJGQ2VT4BXCN5EM",
  "format": "ulid"
}

Decode a v7 UUID

curl -X POST https://morso.dev/api/uuid \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"action": "decode", "value": "018f6b1a-5b3c-7d4e-8f9a-1b2c3d4e5f60"}'

{
  "value": "018f6b1a-5b3c-7d4e-8f9a-1b2c3d4e5f60",
  "format": "v7",
  "decoded": {
    "version": 7,
    "variant": "RFC 4122",
    "timestamp": "2026-05-06T12:00:00Z",
    "is_ulid": false
  }
}