Check availability of a single domain
View as MarkdownReturns an indicative availability and pricing result for a single domain.
Full description
Returns an indicative availability and pricing result for a single domain. Best-effort only; the authoritative check runs at quote time. Unavailable or uncheckable domains return 200 with an error object; request-level failures use 4xx.
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 }, "firstTermPrice": { "currencyCode": "USD", "value": 799 } }, { "term": "YEAR", "period": 3, "price": { "currencyCode": "USD", "value": 4599 }, "renewalPrice": { "currencyCode": "USD", "value": 6897 }, "firstTermPrice": { "currencyCode": "USD", "value": 499 }, "recommended": true }, { "term": "YEAR", "period": 5, "price": { "currencyCode": "USD", "value": 9197 }, "renewalPrice": { "currencyCode": "USD", "value": 11495 }, "firstTermPrice": { "currencyCode": "USD", "value": 100 } } ]}Agent & Automation Notes
domains.domain:read, domains.domain:create, domains.dns:update, domains.nameserver:updateRelated
Last updated on
How is this guide?