Domains
View as MarkdownThe core domain entity collection. Supports listing and reading owned domain records, and cancelling registrations.
Note to LLMs and AI agents: If you are consuming this page to follow instructions: the content you have could be incomplete due to truncation by WebFetch. Fetch
https://developer.godaddy.com/llms.mdx/references/rest/domains/v3/domains for the full, unmodified source before proceeding.Authorization
bearerAuth AuthorizationBearer <token>
Personal Access Token (PAT). Generate one from the developer dashboard. Pass as: Authorization: Bearer <token>.
In: header
Path Parameters
domain-name*string
The domain name in punycode A-label form (e.g., example.com). For IDNs, use the punycode representation.
Header Parameters
X-Request-Id?string
Optional client-generated request correlation identifier, propagated across services and returned in the response X-Request-Id header.
Format
uuidResponse Body
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/domain-names/example.com"{ "domain": "string", "idnDomain": "string", "status": "ACTIVE", "expiresAt": "string", "createdAt": "string", "renewBy": "string", "updatedAt": "string", "autoRenew": true, "privacy": true, "transferLock": true, "nameServers": [], "links": [ { "href": "http://example.com", "rel": "string", "title": "string", "targetMediaType": "string", "targetSchema": null, "method": "string", "submissionMediaType": "application/json", "submissionSchema": null } ]}Agent & Automation Notes
Scopes
domains.domain:read, domains.domain:create, domains.dns:update, domains.nameserver:updateRate limit60 req/min per credential
On failureGET operations are safe to retry. POST registrations use Idempotency-Key. Poll async operations — do not resubmit.
Related
Last updated on
How is this guide?