API Usage

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

API Usage

API Base Url

https://uuid.rocks

Global Flags

?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

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

Uses the ulidx package to generate ULID’s.

Eg. 01FB0CCPD8R0H9KAJBFQJDFYJB

?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:

/short or /s

Gets single Short UUID in plaintext

https://uuid.rocks/short

8JcPuGbL63o8JuDAFjiKpx

/ulid

Gets single ULID in plaintext

https://uuid.rocks/ulid

01FB0CCPD8R0H9KAJBFQJDFYJB

/nanoid

Gets single NANOID in plaintext

https://uuid.rocks/nanoid

ebC664LIj9xy9_8ANdlF4

/stats

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

https://uuid.rocks/stats

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

/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

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.

/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

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

Gets single UUID in plaintext

https://uuid.rocks/plain

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

/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

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

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

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

e1979ebe-1ab1-44e5-9146-f8dd971e665a