The status method checks the availability status of a single domain name. It accepts one argument:
The response will contain a JSON array of
status objects with keys:
status key is a space-delimited list of status types for the given domain, in increasing order of precedence.
To prevent resource exhaustion, our platform limits API requests to a total runtime of 30 seconds. If an upstream provider fails to respond within this limit, requests to the
status API will return a best-effort value, typically
|Domain name you are checking (required).
Availability for Registration
The most common use-case of the
status API is to determine if a domain is immediately registrable via registrars or resellers, e.g. not via the aftermarket.
For this usage, the
inactive status means a domain is available for registration.
If you see the
unknown status, this means the Domainr backend was unable to determine an authoritative status from its upstream sources. This is commonly due to a domain registry backend operator being offline due to scheduled maintenance. The OpenSRS service maintains an up-to-date log of scheduled registry maintenance.
"status": "undelegated inactive",
"summary": "inactive" // Deprecated
The API returns status as a space-separated list of status flags, in increasing order of priority.
The last (right-most) status can be considered the the most important status. e.g. the status for .com is
active zone tld, meaning it is in
active use (registered), a
zone in our database, and a top-level domain (summarized as
Note: Some of the new top-level domain registries sell a subset of their domains as “premium,” e.g. with special tiered pricing. The Status API will mark these with status
These are the responses that appear for
|Unknown status, usually resulting from an error or misconfiguration.
|The domain is not present in DNS.
|Available for new registration.
|TLD not yet in the root zone file.
|Disallowed by the registry, ICANN, or other (wrong script, etc.).
|Claimed or reserved by some party (not available for new registration).
|Explicitly reserved by ICANN, the registry, or another party.
|Domains Protected Marks List, reserved for trademark holders.
|A domain longer than 64 characters.
|Technically invalid, e.g. too long or too short.
|Registered, but possibly available via the aftermarket.
|Active and parked, possibly available via the aftermarket.
|Explicitly marketed as for sale via the aftermarket.
|An expiring domain.
|e.g. in the Redemption Grace Period, and possibly available via a backorder service. Not guaranteed to be present for all
|A expired domain pending removal from the registry.
|e.g. in the Pending Delete phase, and possibly available via a backorder service. Not guaranteed to be present for all
|An aftermarket domain with an explicit price.
|e.g. via the BuyDomains service.
|An aftermarket domain available for fast-transfer.
|e.g. in the Afternic inventory.
|Premium domain name for sale by the registry.
|A public suffix according to publicsuffix.org.
|A zone (domain extension) in the Domainr database.
|A top-level domain.
summary field in API responses is deprecated. It is a developer-centric hint about the most significant status present, not the final availability status. The
status values represent the actual availability status.