GoDaddy
Support
API ReferenceDomainDomain LifecycleDomains & DNSv1 (Legacy)Manage Domain SettingsCancel a purchased domain DELETE

Cancel a purchased domain

View as Markdown

Cancels a purchased domain and initiates a refund if within the cancellation window.

Full description

Cancels a purchased domain and initiates a refund if within the cancellation window. This action is irreversible.

DELETE
/v1/domains/{domain}

Authorization

bearerAuth
AuthorizationBearer <token>

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

In: header

Path Parameters

domain*string

Domain to cancel

Response Body

curl -X DELETE "https://example.com/v1/domains/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?