Check the availability of one or more domains

Check if a domain name is available for purchase. You can check multiple domains at once.

GET /domains/status

Python

Python

from dub import Dub


with Dub(
    token="DUB_API_KEY",
) as d_client:

    res = d_client.domains.check_status(request={
        "domains": "<value>",
    })

    # Handle response
    print(res)

200

[
  {
    "domain": "<string>",
    "available": true,
    "price": "<string>",
    "premium": true
  }
]

Domain registration is only available for certain Enterprise customers. Please contact us to get access.

Authorizations

Authorization · string · header · required

Default authentication mechanism

Query Parameters

domains · string string[] · required

The domains to search. We only support .link domains for now.

Response

200

application/json

The domain status was retrieved.

domain · string · required

The domain name.

available · boolean · required

Whether the domain is available.

price · string | null · required

The price description.

premium · boolean | null · required

Whether the domain is a premium domain.