{"openapi":"3.1.0","info":{"title":"Unique Identifiers (UUID + ULID)","version":"0.1.0","description":"Generate and inspect unique identifiers in one place. `uuid` mints RFC 4122/9562 UUIDs (v4 random, v7 time-ordered); `inspect` parses a UUID's version, variant and embedded timestamp. `ulid` mints lexicographically sortable ULIDs; `decode` parses a ULID's timestamp and entropy. Deterministic.","x-guidance":"Generate and inspect unique identifiers in one place. `uuid` mints RFC 4122/9562 UUIDs (v4 random, v7 time-ordered); `inspect` parses a UUID's version, variant and embedded timestamp. `ulid` mints lexicographically sortable ULIDs; `decode` parses a ULID's timestamp and entropy. Deterministic. Each operation is an HTTP POST to its /v1/<operation> path with a JSON request body (see each operation's requestBody schema) and returns a JSON response. Endpoints are paid per successful call via x402 or MPP (USDC on Base); an unpaid request returns 402 with payment metadata in the WWW-Authenticate header.","contact":{"email":"hello@openverbs.com"}},"x-discovery":{"ownershipProofs":["0xb1401a71756f51464a9962db12f1eb3e9522490cd20010b06d00cf7b7770acfd5f79721f9dfdf2643f8cecd29af3bde9ec133941a386042b32d9886053a70de61b","0xc1c1f11793e18a00fcb7072421f26e89fb75b6aa517fa84370564991f4b10efa024f6f57e4e67eefd20cf46cc01fc5a62d793fa8fbcda04f26c946a3433d73f91b","0x676b474af0ef9ed4809b5d12d2e789b36e52d56215b21f601d71f76620e36ec630347116a7b2b349a3c3681e5db0fbfa76c4169a676b6d6f27864d0e5017284a1c","0xc2ab96522515ed9e9bc4f1a241b774bd48df42e951ddbf7f6aa8fc76f5a96a20421703e1ec402ce7eb1e4eabea3b6e4e4129cf39d56ea91cf4fcf38561fc94fc1c"]},"servers":[{"url":"https://id.openverbs.com"}],"paths":{"/health":{"get":{"summary":"Health check","security":[],"responses":{"200":{"description":"Healthy","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"service":{"type":"string"},"version":{"type":"string"}}}}}}}}},"/v1/uuid":{"post":{"summary":"Generate a UUID (v4/v7)","description":"Generate one or more UUIDs. Supports v4 (random), v1/v7 (time), and v3/v5 (namespaced). Paid endpoint (x402 + MPP). Price: $0.002000 USDC per successful payment.","tags":["generate uuid","uuid generator api","create guid","v4 uuid generation","v7 uuid generation","namespaced uuid"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"version":{"type":"string","enum":["v1","v3","v4","v5","v7"],"description":"UUID version. Defaults to v4."},"count":{"type":"integer","minimum":1,"maximum":1000,"description":"How many UUIDs to generate. Defaults to 1."},"namespace":{"type":"string","minLength":1,"maxLength":64,"description":"v3/v5 only: a keyword (dns|url|oid|x500) or a namespace UUID."},"name":{"type":"string","maxLength":1024,"description":"v3/v5 only: the name hashed within the namespace."}},"additionalProperties":false}}}},"responses":{"200":{"description":"The `version`, `count`, and the generated `uuids` array.","content":{"application/json":{"schema":{"type":"object","description":"The `version`, `count`, and the generated `uuids` array."}}}},"400":{"description":"Invalid request; no payment is attempted"},"402":{"description":"Payment required; x402/MPP metadata returned in headers"},"502":{"description":"Upstream provider error after payment verification"}},"x-payment-info":{"amount":"2000","currency":"0x20c000000000000000000000b9537d11c60e8b50","description":"Generate one or more UUIDs. Supports v4 (random), v1/v7 (time), and v3/v5 (namespaced).","method":"tempo","preferredOffer":"mpp-tempo","price":{"mode":"fixed","currency":"USD","amount":"0.002000"},"protocols":[{"x402":{"scheme":"exact","network":"eip155:8453","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A"}},{"mpp":{"method":"evm","intent":"charge","network":"8453","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A"}},{"mpp":{"method":"tempo","intent":"charge","network":"4217","currency":"0x20c000000000000000000000b9537d11c60e8b50","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A"}}],"network":"4217","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A","offers":[{"amount":"2000","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","description":"Generate one or more UUIDs. Supports v4 (random), v1/v7 (time), and v3/v5 (namespaced).","intent":"charge","method":"evm","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A"},{"amount":"2000","currency":"0x20c000000000000000000000b9537d11c60e8b50","description":"Generate one or more UUIDs. Supports v4 (random), v1/v7 (time), and v3/v5 (namespaced).","intent":"charge","method":"tempo","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A"}]}}},"/v1/inspect":{"post":{"summary":"Inspect a UUID","description":"Validate a UUID and report its version and variant. Paid endpoint (x402 + MPP). Price: $0.002000 USDC per successful payment.","tags":["inspect uuid","validate uuid","uuid version lookup","parse guid","uuid variant check"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"uuid":{"type":"string","minLength":1,"maxLength":128,"description":"The UUID string to validate and inspect."}},"required":["uuid"],"additionalProperties":false}}}},"responses":{"200":{"description":"Whether it is `valid`, the normalized `uuid`, its `version` (0–15) and `variant`.","content":{"application/json":{"schema":{"type":"object","description":"Whether it is `valid`, the normalized `uuid`, its `version` (0–15) and `variant`."}}}},"400":{"description":"Invalid request; no payment is attempted"},"402":{"description":"Payment required; x402/MPP metadata returned in headers"},"502":{"description":"Upstream provider error after payment verification"}},"x-payment-info":{"amount":"2000","currency":"0x20c000000000000000000000b9537d11c60e8b50","description":"Validate a UUID and report its version and variant.","method":"tempo","preferredOffer":"mpp-tempo","price":{"mode":"fixed","currency":"USD","amount":"0.002000"},"protocols":[{"x402":{"scheme":"exact","network":"eip155:8453","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A"}},{"mpp":{"method":"evm","intent":"charge","network":"8453","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A"}},{"mpp":{"method":"tempo","intent":"charge","network":"4217","currency":"0x20c000000000000000000000b9537d11c60e8b50","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A"}}],"network":"4217","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A","offers":[{"amount":"2000","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","description":"Validate a UUID and report its version and variant.","intent":"charge","method":"evm","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A"},{"amount":"2000","currency":"0x20c000000000000000000000b9537d11c60e8b50","description":"Validate a UUID and report its version and variant.","intent":"charge","method":"tempo","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A"}]}}},"/v1/ulid":{"post":{"summary":"Generate a ULID","description":"Generate one or more lexicographically sortable ULIDs (monotonic within a call). Paid endpoint (x402 + MPP). Price: $0.002000 USDC per successful payment.","tags":["generate ulid","ulid generator api","create sortable id","time ordered identifier","monotonic ulid"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":1000,"description":"How many ULIDs to generate. Defaults to 1."},"time":{"type":"integer","minimum":0,"maximum":281474976710655,"description":"Optional Unix ms timestamp to seed the time component. Defaults to now."}},"additionalProperties":false}}}},"responses":{"200":{"description":"The `count` and the generated `ulids` array (ascending order).","content":{"application/json":{"schema":{"type":"object","description":"The `count` and the generated `ulids` array (ascending order)."}}}},"400":{"description":"Invalid request; no payment is attempted"},"402":{"description":"Payment required; x402/MPP metadata returned in headers"},"502":{"description":"Upstream provider error after payment verification"}},"x-payment-info":{"amount":"2000","currency":"0x20c000000000000000000000b9537d11c60e8b50","description":"Generate one or more lexicographically sortable ULIDs (monotonic within a call).","method":"tempo","preferredOffer":"mpp-tempo","price":{"mode":"fixed","currency":"USD","amount":"0.002000"},"protocols":[{"x402":{"scheme":"exact","network":"eip155:8453","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A"}},{"mpp":{"method":"evm","intent":"charge","network":"8453","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A"}},{"mpp":{"method":"tempo","intent":"charge","network":"4217","currency":"0x20c000000000000000000000b9537d11c60e8b50","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A"}}],"network":"4217","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A","offers":[{"amount":"2000","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","description":"Generate one or more lexicographically sortable ULIDs (monotonic within a call).","intent":"charge","method":"evm","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A"},{"amount":"2000","currency":"0x20c000000000000000000000b9537d11c60e8b50","description":"Generate one or more lexicographically sortable ULIDs (monotonic within a call).","intent":"charge","method":"tempo","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A"}]}}},"/v1/decode":{"post":{"summary":"Decode a ULID","description":"Validate a ULID and extract its embedded timestamp and time/random components. Paid endpoint (x402 + MPP). Price: $0.002000 USDC per successful payment.","tags":["decode ulid","parse ulid timestamp","validate ulid","ulid time lookup","inspect sortable id"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ulid":{"type":"string","minLength":1,"maxLength":64,"description":"The 26-character ULID to decode."}},"required":["ulid"],"additionalProperties":false}}}},"responses":{"200":{"description":"Whether it is `valid`, the `timestamp` (ms) and `datetime` (ISO), and the `timeComponent`/`randomComponent`.","content":{"application/json":{"schema":{"type":"object","description":"Whether it is `valid`, the `timestamp` (ms) and `datetime` (ISO), and the `timeComponent`/`randomComponent`."}}}},"400":{"description":"Invalid request; no payment is attempted"},"402":{"description":"Payment required; x402/MPP metadata returned in headers"},"502":{"description":"Upstream provider error after payment verification"}},"x-payment-info":{"amount":"2000","currency":"0x20c000000000000000000000b9537d11c60e8b50","description":"Validate a ULID and extract its embedded timestamp and time/random components.","method":"tempo","preferredOffer":"mpp-tempo","price":{"mode":"fixed","currency":"USD","amount":"0.002000"},"protocols":[{"x402":{"scheme":"exact","network":"eip155:8453","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A"}},{"mpp":{"method":"evm","intent":"charge","network":"8453","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A"}},{"mpp":{"method":"tempo","intent":"charge","network":"4217","currency":"0x20c000000000000000000000b9537d11c60e8b50","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A"}}],"network":"4217","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A","offers":[{"amount":"2000","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","description":"Validate a ULID and extract its embedded timestamp and time/random components.","intent":"charge","method":"evm","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A"},{"amount":"2000","currency":"0x20c000000000000000000000b9537d11c60e8b50","description":"Validate a ULID and extract its embedded timestamp and time/random components.","intent":"charge","method":"tempo","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A"}]}}}},"x-service-info":{"categories":["compute"],"docs":{"homepage":"https://id.openverbs.com","apiReference":"https://id.openverbs.com/openapi.json"}}}