API Usage

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

ENDPOINTS

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

/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"}

/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