Status

The status method checks the availability status of a single domain name. It accepts one argument: domain

The response will contain a JSON array of status objects with keys: domain and status*. The 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 unknown or undelegated.

Arguments

ParameterDescriptionExample
domainDomain name you are checking (required).domain=acmecoffee.com

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.

Example

Request

/v2/status?domain=acmecoffee.shop

Response

{
 "status": [
  {
   "domain": "acmecoffee.shop",
   "zone": "shop",
   "status": "undelegated inactive",
   "summary": "inactive" // Deprecated
  }
 ]
}

Status Results

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 tld).

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 premium.

These are the responses that appear for status queries:

StatusExampleDescription
unknownfoobar.llpUnknown status, usually resulting from an error or misconfiguration.
undelegatedhello.eduThe domain is not present in DNS.
inactivenonexistent.xyzAvailable for new registration.
pendingheartb.eatTLD not yet in the root zone file.
disalloweda.mobiDisallowed by the registry, ICANN, or other (wrong script, etc.).
claimedfedex.nameClaimed or reserved by some party (not available for new registration).
reserveds.workExplicitly reserved by ICANN, the registry, or another party.
dpmlgoogle.bargainsDomains Protected Marks List, reserved for trademark holders.
invalidA domain longer than 64 characters.Technically invalid, e.g. too long or too short.
activevertical.coffeeRegistered, but possibly available via the aftermarket.
parkedwi.ioActive and parked, possibly available via the aftermarket.
marketedwi.ioExplicitly marketed as for sale via the aftermarket.
expiringAn expiring domain.e.g. in the Redemption Grace Period, and possibly available via a backorder service. Not guaranteed to be present for all expiring domains.
deletingA 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 deleting domains.
pricedAn aftermarket domain with an explicit price.e.g. via the BuyDomains service.
transferableAn aftermarket domain available for fast-transfer.e.g. in the Afternic inventory.
premiumace.pizzaPremium domain name for sale by the registry.
suffixblogspot.comA public suffix according to publicsuffix.org.
zone.co.ukA zone (domain extension) in the Domainr database.
tld.comA top-level domain.

*Note: the 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.