Skip to main content
GET
/
api
/
v1
/
domains
/
availability
Check domain availability
curl --request GET \
  --url https://dev.namify.host/api/v1/domains/availability \
  --header 'Authorization: Bearer <token>'
{
  "results": [
    {
      "product_category": "domain_registration",
      "domain_name": "example.com",
      "sld": "example",
      "tld": "com",
      "available": true,
      "premium": false
    },
    {
      "product_category": "domain_registration",
      "domain_name": "example.tech",
      "sld": "example",
      "tld": "tech",
      "available": false,
      "premium": false
    }
  ]
}
Premium domains are not currently supported by our APIs for registration.

Authorizations

​
Authorization
string
header
required

A personal access token. Obtain one from the dashboard under Settings > API Key. Include it in the Authorization header as Bearer <token>. Unauthenticated requests to protected routes return 401 Unauthorized.

Query Parameters

​
search_term
required

SLD (label only, no dots) to check. Accepts a single string or a repeated parameter for multiple SLDs (e.g. search_term[]=example&search_term[]=myshop). Must be 1–63 alphanumeric characters or hyphens; cannot start or end with a hyphen.

Example:

"example"

​
tlds[]
string[]

TLD extensions to check (without leading dot, e.g. com, store, tech, online). Filtered to your partner's allowed TLD list. If omitted or all values are unrecognised, defaults to your first allowed TLD.

Example:
["com", "store", "tech"]

Response

Availability results for each requested domain+TLD combination.

​
results
object[]