Skip to content
POST AI agent ready /v1/uuid/v7

UUID v7 API - Free Time-Ordered UUID Generator

Returns a UUID v7 with an embedded Unix millisecond timestamp in the most significant bits. UUID v7 values are naturally sorted by creation time, making them ideal for database primary keys where index locality matters.

Code examples

curl -X POST https://api.botoi.com/v1/uuid/v7 \
  -H "Content-Type: application/json" \
  -d '{}'

When to use this API

High-write database primary keys

Use UUID v7 for tables with millions of inserts. The time-ordered prefix keeps B-tree and LSM-tree indexes compact and reduces page splits.

Cursor-based pagination

Because UUID v7 values sort chronologically, you can paginate results using the ID directly instead of maintaining a separate cursor column.

Frequently asked questions

Why choose UUID v7 over UUID v4?
UUID v7 embeds a timestamp, so values sort in creation order. This keeps database indexes efficient and eliminates the need for a separate timestamp column when ordering.
Can I extract the timestamp from a UUID v7?
Yes. The first 48 bits encode a Unix millisecond timestamp. Most UUID libraries provide a method to extract it.
Is UUID v7 an official standard?
Yes. UUID v7 is defined in RFC 9562 (published May 2024), the successor to RFC 4122.
How many random bits does UUID v7 have?
UUID v7 has 74 bits of randomness (after the 48-bit timestamp and version/variant bits), which is more than enough to avoid collisions in distributed systems.

Get your API key

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.