Discovery
View as MarkdownIndicative, non-committing operations for finding and checking domains. Use suggestDomains for natural-language queries and getDomainAvailability for specific domain verification. Both return indicative pricing; locked pricing is established only at quote time. The check-availability controller carries no persistent identity.
https://developer.godaddy.com/llms.mdx/references/rest/domains/v3/discovery for the full, unmodified source before proceeding.Authorization
bearerAuth Personal Access Token (PAT). Generate one from the developer dashboard. Pass as: Authorization: Bearer <token>.
In: header
Query Parameters
Natural-language query or keywords describing the desired domain, e.g. "sunrise bakery". Used to generate creative and keyword-spin suggestions.
length <= 100Top-level domains to be included in suggestions.
Maximum length of second-level domain.
1 <= valueMinimum length of second-level domain.
1 <= valueMaximum number of suggestions in the response. Defaults to 10 when omitted.
1 <= value <= 5010Suggestion source strategies to activate.
Header Parameters
Optional client-generated request correlation identifier, propagated across services and returned in the response X-Request-Id header.
uuidResponse Body
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/suggestions?query=sunrise+bakery&tlds=com%2Cnet%2Cshop&sources=EXTENSION%2CKEYWORD_SPIN"{ "items": [ { "domain": "string", "prices": [ { "term": "YEAR", "period": 1, "price": { "currencyCode": "str", "value": 0 }, "renewalPrice": { "currencyCode": "str", "value": 0 } } ], "inventory": "REGISTRY" } ]}Authorization
bearerAuth Personal Access Token (PAT). Generate one from the developer dashboard. Pass as: Authorization: Bearer <token>.
In: header
Query Parameters
The domain name to check, in punycode A-label form for IDNs.
Optional. When omitted, defaults to SPEED. Availability is always re-verified authoritatively at quote time regardless of this setting.
"SPEED"Value in
- "SPEED"
- "ACCURACY"
ISC (International Shopper Code) for pricing context. When provided, prices reflect the applicable rates for this ISC.
Header Parameters
Optional client-generated request correlation identifier, propagated across services and returned in the response X-Request-Id header.
uuidResponse Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/check-availability?domain=example.com&optimizeFor=SPEED&iscCode=ISC_PARTNER_001"{ "domain": "coffee24x7x365.com", "available": true, "definitive": false, "inventory": "REGISTRY", "prices": [ { "term": "YEAR", "period": 1, "price": { "currencyCode": "USD", "value": 1199 }, "renewalPrice": { "currencyCode": "USD", "value": 2299 } }, { "term": "YEAR", "period": 2, "price": { "currencyCode": "USD", "value": 3098 }, "renewalPrice": { "currencyCode": "USD", "value": 4598 } }, { "term": "YEAR", "period": 3, "price": { "currencyCode": "USD", "value": 4599 }, "renewalPrice": { "currencyCode": "USD", "value": 6897 } }, { "term": "YEAR", "period": 5, "price": { "currencyCode": "USD", "value": 9197 }, "renewalPrice": { "currencyCode": "USD", "value": 11495 } } ]}Agent & Automation Notes
domains.domain:read, domains.domain:create, domains.dns:update, domains.nameserver:updateRelated
Last updated on
How is this guide?