Purchase a domain

Purchase a domain for one year using the user's saved payment method. Requires domains:write permission.

Requires a WHOIS registrant contact: pass contact, or save one at https://namemy.app/app/settings first. Without either the call fails with contact_required and lists the missing fields.

The flow places a hold on the saved card, provisions the domain, then captures payment. If provisioning fails, the hold is released.

post/domains/buy

Request

  • Base URL: https://namemy.app/api/v1
  • URL: https://namemy.app/api/v1/domains/buy
  • Auth: HTTP bearer

Request body

domainstring required

Domain to purchase

privacyboolean

Enable WHOIS privacy

autoRenewboolean

Example request

{
  "domain": "taskflow.app"
}

Response

Purchase successful

successboolean
domainstring
registrarstring
retailPricenumber
currencystring
paymentIntentstring
elapsedMsinteger

Example response

{
  "success": true,
  "registrar": "namemy.app",
  "currency": "usd"
}

Changes

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