GoDaddy
Support
API ReferenceDomainDomain LifecycleDomains & DNSv1 (Legacy)Register and Renew DomainsValidate a domain purchase request body POST

Validate a domain purchase request body

View as Markdown

Validates a purchase request body against the TLD schema with no side effects and no charge.

Full description

Validates a purchase request body against the TLD schema with no side effects and no charge. Returns 200 on success.

POST
/v1/domains/purchase/validate

Authorization

bearerAuth
AuthorizationBearer <token>

Personal Access Token (PAT). Generate one from the developer dashboard. Pass as: Authorization: Bearer .

In: header

Request Body

An instance document expected to match the JSON schema returned by ./schema/{tld}

Response Body

curl -X POST "https://example.com/v1/domains/purchase/validate" \  -H "Content-Type: application/json" \  -d '{    "consent": {      "agreedAt": "string",      "agreedBy": "string",      "agreementKeys": [        "string"      ]    },    "domain": "string"  }'
Empty

Agent & Automation Notes

Scopesdomains.domain:read, domains.domain:create, domains.domain:delete, domains.domain:update, domains.contact:update, domains.dns:update, domains.transfer:execute
Rate limit60 req/min per credential
On failureGET operations are safe to retry. PUT/PATCH DNS are idempotent by shape. POST purchase is NOT idempotent — verify state before retrying.

Related

Last updated on

How is this guide?