Skip to main content
POST
/
v1
/
domains
/
purchase
Purchase Domain
curl --request POST \
  --url https://api.example.com/v1/domains/purchase
Creates a checkout session to purchase a domain. After payment, the domain is registered via the domain registrar and DNS is provisioned automatically. Maximum 3 purchased domains per company.

​
Request Body

ParameterTypeRequiredDescription
domainstringYesDomain to purchase (check availability first)

​
Response

{
  "checkout_url": "https://checkout.example.com/c/pay/...",
  "session_id": "cs_live_...",
  "domain_id": "550e8400-e29b-41d4-a716-446655440000",
  "domain": "coolstartup.ai",
  "price": "$25",
  "expires_at": "2026-05-02T11:30:00Z",
  "hint": "Open the checkout URL to complete payment. The domain will be registered automatically."
}
After payment, check GET /v1/domains to verify the domain status has changed from pending_payment to active.
May require approval. If the user’s Account Kit gates domains.purchase, an agent (API-key) call returns 202 { "status": "pending_approval", "approval_id" } instead of creating the checkout. A human approves it via Approvals; the purchase runs on replay. See Approvals.