Skip to main content
POST
Check Availability

Authorizations

Authorization
string
header
required

Authenticate via HTTP Basic with your account username and API token. Examples use an explicit 'Authorization: Basic <base64(username:token)>' header; 'curl -u username:token' is equivalent. For sandbox, append "-test" to your username and use your sandbox token on api.dev.name.com.

Body

application/json

AvailabilityRequest is used to list the domain names to check availability for.

Checks if one or more domain names are available for registration (up to 50 domains). Important: Do not encode the : in the path. Use /core/v1/domains:checkAvailability, not /core/v1/domains%3AcheckAvailability.

domainNames
string[]
required

DomainNames is the list of domains to check if they are available.

Required array length: 1 - 50 elements
Minimum string length: 1
purchaseType
enum<string>

Optional filter. Recommended: registration for most integrations — omit only if you support acquisition types. Non-matching domains are returned with purchasable: false (Search omits them instead). See the Domain purchase pricing guide.

Available options:
registration,
aftermarket_i,
expiring,
backorder,
aftermarket_s,
aftermarket_b

Response

A successful response.

SearchResponse returns a list of search results.

results
object[]

Results of the search are returned here, the order should not be relied upon.