API Usage
This is the current API, no API key needed. Get all the UUID’s you need!
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
8JcPuGbL63o8JuDAFjiKpx
/ulid
Gets single ULID in plaintext
01FB0CCPD8R0H9KAJBFQJDFYJB
/nanoid
Gets single NANOID in plaintext
ebC664LIj9xy9_8ANdlF4
/stats
Gets some stats about service usage, tracked via countapi.xyz
{"uuids_generated":1376, "stats_viewed_count":77}
/json
Gets single uuid with JSON output
{ "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
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-e1a40c7504d4224c9b6a-37be-4abf-8dca-3c29ca210715fe254c86-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