GoDaddy
Support
API ReferenceDomainDomain LifecycleDomains & DNSv1 (Legacy)Find DomainsCheck availability of multiple domains POST

Check availability of multiple domains

View as Markdown

Checks availability for multiple domains in a single request.

Full description

Checks availability for multiple domains in a single request. Returns an array of availability and pricing results, one per domain queried.

POST
/v1/domains/available

Authorization

bearerAuth
AuthorizationBearer <token>

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

In: header

Query Parameters

checkType?string

Optimize for time ('FAST') or accuracy ('FULL')

Default"FAST"

Value in

  • "FAST"
  • "FULL"
  • "fast"
  • "full"

Request Body

Domain names for which to check availability

Rangevalue <= 500
[index: integer]?string

Response Body

curl -X POST "https://example.com/v1/domains/available" \  -H "Content-Type: application/json" \  -d '[    "string"  ]'
{  "domains": [    {      "available": true,      "currency": "USD",      "definitive": true,      "domain": "string",      "period": 0,      "price": 0    }  ]}

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?