Search domain availability

GET

/domains/search

• Production

Checks if a domain name is available for registration across one or more TLDs. Rate limited: 60 requests per minute per IP.

Parameters

Query Parameters

query

required

string

>= 1 characters <= 63 characters /^[a-zA-Z0-9]([a-zA-Z0-9-]*[a-zA-Z0-9])?$/

Domain name to search for (without TLD). Must be 1-63 characters, alphanumeric and hyphens only.

tlds

string

Comma-separated list of TLDs to check (e.g. “com,io,xyz”). Defaults to a standard set if omitted.

Example

com,io,xyz

Responses

200

Search results returned

object

query

required

The search query that was submitted

string

results

required

Availability results for each TLD

Array<object>

object

domain

required

Full domain name (e.g. “example.com”)

string

tld

required

Top-level domain (e.g. “com”)

string

available

required

Whether the domain is available for registration

boolean

400

Invalid query parameter

object

error

required

Short error description

string

message

required

Human-readable error message

string

code

required

Machine-readable error code

string

429

Rate limit exceeded

object

error

required

Short error description

string

message

required

Human-readable error message

string

code

required

Machine-readable error code

string