code

Verifiable UUID

Operational

Generate RFC 9562 UUIDs (v4 or v7) derived from the drand League of Entropy beacon

API Overview

UUID v4 uses 122 bits drawn from the drand beacon for full randomness. UUID v7 embeds the current Unix timestamp (milliseconds) in the top 48 bits per RFC 9562, making them monotonically sortable while still cryptographically random in the lower bits. Both variants include a BLS12-381 beacon proof so clients can audit the source of randomness without trusting the server. Batch up to 100 UUIDs per call.

code

RFC 9562 Compliant

Both v4 and v7 strictly follow the latest UUID specification for maximum compatibility.

verified

Beacon-Backed Randomness

Random bits derive from drand's decentralised BLS12-381 threshold network — not a local PRNG.

bolt

Sortable v7 UUIDs

UUID v7 embeds millisecond timestamps so records stay naturally ordered in time-series databases.

speed

Batch Up to 100

Fetch up to 100 UUIDs in one HTTP call to minimise round-trips in bulk provisioning.

integration_instructions API Reference

data_object openapi.json open_in_new Swagger UI

data_object

OpenAPI Spec

openapi.json

open_in_new

description

Swagger UI

Interactive API explorer

open_in_new

GET /api/random/uuid

Body Parameters

Parameter	Type	Required	Description
`version`	integer	No	UUID version: 4 (random) or 7 (timestamp+random), default 4
`count`	integer	No	Number of UUIDs (1–100, default 1)

terminal API Playground

Live Simulation

version (integer)

count (integer)

import requests

url = "https://random.picopayd.codefission.co.uk/api/random/uuid"
params = {"version": 4, "count": 3}
headers = {"X-PAYMENT": "<402-payment-token>"}

response = requests.get(url, params=params, headers=headers)
print(response.json())

const params = new URLSearchParams({ version: 4, count: 3 });
const response = await fetch(
  `https://random.picopayd.codefission.co.uk/api/random/uuid?${params}`,
  { headers: { "X-PAYMENT": "<402-payment-token>" } }
);
const data = await response.json();
console.log(data);

curl "https://random.picopayd.codefission.co.uk/api/random/uuid?version=4&count=3" \
  -H 'X-PAYMENT: <402-payment-token>'

Response Body 200 OK

{
  "uuids": [
    "f47ac10b-58cc-4372-a567-0e02b2c3d479",
    "550e8400-e29b-41d4-a716-446655440000",
    "6ba7b810-9dad-11d1-80b4-00c04fd430c8"
  ],
  "version": 4,
  "proof": {
    "round": 21543892,
    "signature": "95a9...",
    "chainHash": "52db9b...",
    "timestamp": "2026-03-20T10:00:00Z"
  }
}