Skip to content
uuid.rocks

API Usage

This is the current API, no API key needed. Get all the UUID’s you need!

API Base Url

Section titled “API Base Url”

https://uuid.rocks

Global Flags

Section titled “Global Flags”

?readable

Section titled “?readable”

Switches from standard uuidv4 format to Readable UUIDs, that are Shakespearean grammatically correct sentences.

Eg. Nertie Irwin Farris the Tighter of Chandlerville reminded Erica Aguistin Maryl and 8 dapper jaguars

?short

Section titled “?short”

Switches from standard UUIDv4 to a Short ID. These ID’s are converted from UUIDv4 ID’s so they are just as unique & colission free.

Eg. rZMRC1FzqYjVLxNN6iKqqq

?ulid

Section titled “?ulid”

Uses the ulidx package to generate ULID’s.

Eg. 01FB0CCPD8R0H9KAJBFQJDFYJB

?nanoid

Section titled “?nanoid”

Uses the nanoid package to generate ID’s. Supports &len= param to adjust ID length. If this is not a number it will be silently ignored. If used in combonation with bulk api, may fail if len is too long.

Endpoints

Section titled “Endpoints”

/short or /s

Section titled “/short or /s”

Gets single Short UUID in plaintext

https://uuid.rocks/short

8JcPuGbL63o8JuDAFjiKpx

/ulid

Section titled “/ulid”

Gets single ULID in plaintext

https://uuid.rocks/ulid

01FB0CCPD8R0H9KAJBFQJDFYJB

/nanoid

Section titled “/nanoid”

Gets single NANOID in plaintext

https://uuid.rocks/nanoid

ebC664LIj9xy9_8ANdlF4

/stats

Section titled “/stats”

Gets some stats about service usage, tracked via countapi.xyz

https://uuid.rocks/stats

{"uuids_generated":1376, "stats_viewed_count":77}

/json

Section titled “/json”

Gets single uuid with JSON output

https://uuid.rocks/json

{
  "apiVersion": "v1.0.0",
  "uuid": "cf0def33-cf7d-4648-b42d-3a1253cc4000",
  "timestamp": "2020-06-11T07:05:15.976Z"
}

/json/bulk?count=:count

Section titled “/json/bulk?count=:count”

Gets uuids in bulk (up to 20k) with JSON output

https://uuid.rocks/json/bulk?count=3

{
  "apiVersion": "v1.0.0",
  "uuids": [
    "648cc8fd-a8ea-486e-bc3b-f64ee74ff4be",
    "0e0c4a60-5018-408d-88dd-440e40bd92aa",
    "373e263d-4f8c-485b-9a10-b16838a7717c"
  ],
  "timestamp": "2020-06-11T07:05:07.500Z"
}

NOTE: Mapping API’s are depricated and will be removed

Section titled “NOTE: Mapping API’s are depricated and will be removed”

/json/map/:namespace/:key

Section titled “/json/map/:namespace/:key”

Maps a namespace/key combo to the same UUID every time

https://uuid.rocks/json/map/exampleNamespace/exampleKey

{"apiVersion":"v1.1.0","uuid":"e1979ebe-1ab1-44e5-9146-f8dd971e665a","timestamp":"2020-07-13T13:17:50.014Z","created_at":"2020-06-24T20:11:01.284Z","message":"Returned saved UUID!"}

/json/map/:key

Section titled “/json/map/:key”

Maps a key to the same UUID every time (in the “default” namespace)

https://uuid.rocks/json/map/exampleKey

{"apiVersion":"v1.1.0","uuid":"e1979ebe-1ab1-44e5-9146-f8dd971e665a","timestamp":"2020-07-13T13:17:50.014Z","created_at":"2020-06-24T20:11:01.284Z","message":"Returned saved UUID!"}

/plain

Section titled “/plain”

Gets single UUID in plaintext

https://uuid.rocks/plain

9fe6eb19-5c4d-4af1-a72c-e925ad767f57

/plain/bulk?count=:count

Section titled “/plain/bulk?count=:count”

Gets uuids in bulk (up to 20k) in plaintext

https://uuid.rocks/plain/bulk?count=3

4dfa8b78-41f3-42e8-ad25-e1a40c7504d4
224c9b6a-37be-4abf-8dca-3c29ca210715
fe254c86-c16f-4768-a8b8-9a7889141eb9

/plain/map/:namespace/:key

Section titled “/plain/map/:namespace/:key”

Maps a namespace/key combo to the same UUID every time

https://uuid.rocks/plain/map/exampleNamespace/exampleKey

e1979ebe-1ab1-44e5-9146-f8dd971e665a

/plain/map/:key

Section titled “/plain/map/:key”

Maps a key to the same UUID every time (in the “default” namespace)

https://uuid.rocks/plain/map/exampleKey

e1979ebe-1ab1-44e5-9146-f8dd971e665a