Check the availability of one or more domains

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

1 min read

get/domains/status

Request example

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)

Response

[
  {
    "domain": "<string>",
    "available": true,
    "premium": true,
    "prices": {
      "registration": 1,
      "renewal": 1
    },
    "price": "<string>"
  }
]

get/domains/status

Note

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

Authorization

Authorizationstringheaderrequired#

Default authentication mechanism

Query parameters

domainsstring · string[]required#

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

Responses

application/json

The domain status was retrieved.

domainstringrequired#

The domain name.

availablebooleanrequired#

Whether the domain is available.

premiumbooleanrequired#

Whether the domain is a premium domain.

pricesobjectrequired#

Price details for the domain. Will be null if the domain is not available.

Show child attributes

registrationnumberrequired#

The domain's registration price in USD cents.

renewalnumberrequired#

The domain's renewal price in USD cents.

pricestringrequireddeprecated#

Deprecated: Use prices instead.