API referenceRegistrar
Register a domain (fail-closed; requires Idempotency-Key)
Disabled unless SELL_PURCHASE_ENABLED. A required Idempotency-Key header dedupes retries so a registration is never charged twice.
Authorization
widgetJWT AuthorizationBearer <token>
Short-lived widget JWT minted server-side via POST /v1/tokens. Scoped to one application (and optionally one domain).
In: header
Header Parameters
Idempotency-Key*string
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
curl -X POST "https://example.com/registrar/purchase" \ -H "Idempotency-Key: string" \ -H "Content-Type: application/json" \ -d '{ "domain": "string", "buyer": { "email": "string" } }'Empty
Empty
{ "code": "string", "title": "string", "details": "string"}{ "code": "string", "title": "string", "details": "string"}{ "code": "string", "title": "string", "details": "string"}