{"components":{"schemas":{"Claim":{"properties":{"claimed_at":{"format":"date-time","type":["string","null"]},"ens_assigned_at":{"format":"date-time","type":["string","null"]},"ens_name":{"description":"Recorded ENS name, when present.","type":["string","null"]},"ens_transaction":{"type":["string","null"]},"id":{"description":"Recorded numeric identifier represented as a string.","type":"string"},"name":{"description":"Recorded fully qualified name.","type":["string","null"]},"owner_address":{"description":"Historical wallet ownership evidence, not an entitlement grant.","type":["string","null"]},"status":{"type":["string","null"]},"transaction":{"type":["string","null"]}},"required":["id","name","ens_name","owner_address","status","transaction","ens_transaction","claimed_at","ens_assigned_at"],"type":"object"},"ClaimsError":{"properties":{"error":{"properties":{"code":{"enum":["authentication_required","invalid_claims_query","invalid_cursor","claims_forbidden","claims_unconfigured","claims_unavailable"],"type":"string"}},"required":["code"],"type":"object"}},"required":["error"],"type":"object"},"ClaimsPage":{"properties":{"claims":{"items":{"$ref":"#/components/schemas/Claim"},"type":"array"},"next":{"description":"Opaque continuation cursor; null means there are no more records.","type":["string","null"]}},"required":["claims","next"],"type":"object"},"HTTPError":{"properties":{"errors":{"properties":{"code":{"type":"string"},"detail":{"type":"string"},"hint":{"type":"string"}},"required":["detail","code","hint"],"type":"object"}},"required":["errors"],"type":"object"}},"securitySchemes":{"PrivyAccessToken":{"bearerFormat":"JWT","description":"Privy access token for the requesting account.","scheme":"bearer","type":"http"},"PrivyIdentityToken":{"description":"Privy identity JWT, required alongside the access token. Not a Regents API key.","in":"header","name":"Privy-Id-Token","type":"apiKey"}}},"externalDocs":{"description":"Developer documentation","url":"https://regents.sh/docs"},"info":{"contact":{"name":"Regents Labs","url":"https://regents.sh/contact"},"description":"Public service health and owner-authorized historical name reads. Does not describe wallet transactions, session changes, or separate product APIs.","termsOfService":"https://regents.sh/terms","title":"Regents public read API","version":"1.0.0"},"openapi":"3.1.0","paths":{"/api/v1/claims":{"get":{"description":"Read-only recorded name and transaction evidence. Both Privy credentials are required. Never accepts a chosen owner as authority. Responses use Cache-Control: no-store. Does not mint, transfer, or grant entitlements.","operationId":"listMyHistoricalNameClaims","parameters":[{"description":"The exact next cursor from the previous response, at most 2048 UTF-8 bytes. This is the only supported query parameter.","in":"query","name":"after","required":false,"schema":{"maxLength":2048,"minLength":1,"type":"string"}},{"description":"If supplied, must exactly match the verified account subject. It does not select another owner.","in":"header","name":"X-Privy-User-Id","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClaimsPage"}}},"description":"Authorized historical records; next is null at the end"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClaimsError"}}},"description":"Invalid query or cursor"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClaimsError"}}},"description":"Missing or invalid credentials"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClaimsError"}}},"description":"Account is not authorized for this read"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClaimsError"}}},"description":"Claims service unavailable or unconfigured"},"default":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPError"}}},"description":"Other HTTP error"}},"security":[{"PrivyAccessToken":[],"PrivyIdentityToken":[]}],"summary":"Read historical name claims for the verified account"}},"/healthz":{"get":{"description":"Returns ok when the web service is responding. Does not establish readiness of every external service or wallet flow.","operationId":"getServiceHealth","responses":{"200":{"content":{"text/plain":{"schema":{"const":"ok","type":"string"}}},"description":"Web service is responding"}},"summary":"Read web-service health"}}},"security":[],"servers":[{"url":"https://regents.sh"}]}