Domain purchases

Register a domain.

Charges the workspace and registers the domain in one call. If the registrar refuses after the charge clears, the charge is refunded automatically and the purchase comes back failed.

Send maxTotalCents to refuse the purchase if the price moved since your quote, and autoConnect to attach the new domain to an origin without a second call. Send an Idempotency-Key — this endpoint moves money.

post/v1/domain-purchases

Request

  • Base URL: https://api.domainee.dev
  • URL: https://api.domainee.dev/v1/domain-purchases
  • Auth: HTTP bearer

Headers

Idempotency-Keystring

Any unique string. Retrying with the same key replays the first response instead of repeating the work.

Request body

hostnamestring required
yearsinteger
enableWhoisPrivacyboolean

Rejected with a 400 on TLDs that do not support it.

autoRenewboolean
maxTotalCentsinteger

Abort with price_changed if the total would exceed this.

customerReferencestring

Example request

{
  "hostname": "acme.com",
  "registrant": {
    "phone": "+1.5551234567"
  }
}

Response

The purchase.

Example response

{
  "purchase": {
    "hostname": "acme.com"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.