Skip to main content
Use this endpoint to check whether one or more domain names are available for registration before you commit credits to purchasing them. You can submit a single domain via the domain field or batch up to 20 domains at once using the domains array. Each result tells you whether the domain is available and whether it carries a premium price.

​
Request

Method: POST
Path: /v1/domains/check

​
Body Parameters

​
string
A single domain name to check (e.g. example.com). Use this for one-off lookups. Omit if you are using domains.
​
string[]
An array of up to 20 domain names to check in a single request. Any domains with unsupported TLDs are silently dropped from the results. Omit if you are using domain.
You must provide either domain or domains. Sending a request with neither field returns a 400 Bad Request error.

​
Request Example

​
Response — 200 OK

The response contains a results array with one entry per domain that was checked. Domains with unsupported TLDs are excluded rather than returned as errors.
​
array
An array of availability result objects, one per queried domain.

​
Errors