Domains

Buy a domain

Registers a domain through the built-in registrar. If the account has a card on file the purchase is charged immediately (charged: true, no redirect); otherwise the response includes a Stripe Checkout URL (checkout_url) to complete payment. The domain is created in pending_payment and becomes active once payment completes and registration succeeds. Poll GET /domains/{id} for status.

post/domains/purchase

Request

  • Base URL: https://api.crevio.co/v1
  • URL: https://api.crevio.co/v1/domains/purchase
  • Auth: API key in header Authorization

Headers

Idempotency-Keystring

Makes this write safe to retry: a repeat with the same key replays the first response instead of creating a second resource. Scoped to the account, remembered for 24 hours; reusing a key with a different payload is an error.

Request body

domainstring required

The domain to buy (check availability first).

Response

Checkout created

objectstring
idstring
domainstring
statusstring
checkout_urlstring
hintstring

Changes

No recorded changes to this operation across all 2 revisions of this API.