Sign in

v1

latestOpenAPI 3.1.02026-07-2671111437.2 KB
Domains

Check Availability

Checks whether up to 50 domain names are purchasable and returns discovery pricing for each result.

Discovery endpoint: Returns SearchResult fields — purchaseType, purchasePrice, premium, purchasable. Search returns the same fields for keyword/suggestion flows. Use this endpoint to determine what to send on Create Domain.

When results show premium: true or a non-registration purchaseType, follow the Domain pricing guide before calling Create Domain. For non-registration types, re-check Check Availability immediately before create — acquisition prices can change.

Recommendation: Set purchaseType to registration. Most resellers restrict results to domains with a purchaseType of registration to ensure predictable pricing and immediate fulfillment. Other purchase types (such as aftermarket variants) can introduce higher costs and non-instant transactions that may be delayed or declined by third parties.

post/core/v1/domains:checkAvailability

Request body

domainNamesstring[] required

DomainNames is the list of domains to check if they are available.

purchaseType'registration' | 'aftermarket_i' | 'expiring' | 'backorder' | 'aftermarket_s' | 'aftermarket_b'

Purchase Type indicates what kind of purchase a discovery result represents. Returned by Search and Check Availability — not Zone Check.

Copy the value to Create Domain as purchaseType.

Recommendation: Pass registration on Search and Check Availability unless you choose to support acquisition inventory. Other values are supported but add integration complexity.

Pricing by type:

  • registration — Standard or registry premium. Check the premium flag: when false, omit purchasePrice on create (Get Pricing with matching years is optional for preview only); when true, purchasePrice is required from Get Pricing with matching years. years controls price and registration length.
  • aftermarket_s, aftermarket_b, aftermarket_i — Flat acquisition fee from Search or Check Availability; purchasePrice required. years does not multiply price or guarantee registration length — omit or pass TLD default.
  • expiring, backorder — Flat acquisition fee from Search or Check Availability; purchasePrice required. Get Pricing does not return these prices. years does not multiply price or guarantee registration length — omit or pass TLD default. Renew after acquisition to extend registration.

See the Domain pricing guide.

Response

A successful response.

Example response

{
  "results": [
    {
      "domainName": "example.com",
      "premium": true,
      "purchasable": true,
      "purchasePrice": 10.99,
      "renewalPrice": 10.99,
      "sld": "example",
      "tld": "com"
    }
  ]
}