Check domain availability

GET

/domains/availability/{domain}

Check domain availability. The response also flags premium (non-standard priced) domains: data.is_premium indicates whether the domain is premium, and data.premium_price carries the premium registration and renewal prices (ex. VAT) when it is, or null otherwise. Use these to detect and display a premium price before ordering; the register amount is what you confirm via accept_premium_price on the order endpoint.

Request

Authorization

Add parameter in header

API-Key

Example:

API-Key: ********************

Path Params

Header Params

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://mijn.host/api/v2/domains/availability/domain.com' \
--header 'Accept: application/json' \
--header 'User-Agent: my-application/1.0.0' \
--header 'API-Key: <api-key>' \
--header 'Content-Type: application/json'

Responses

🟢200OK

application/json

Bodyapplication/json

Example

{
    "status": 0,
    "status_description": "string",
    "data": {
        "domain": "string",
        "status": "string",
        "is_premium": true,
        "premium_price": {
            "currency": "string",
            "register": 0,
            "renew": 0
        }
    }
}

🟠400Wrong request method

🟠400SSL connection is required

🟠400No domain set

🟠400Your domain request contains an empty extension

🟠401No valid API key set

🟠401API key has expired

🟠401Remote IP address is not found in the API key whitelist

🟠429Rate limit exceeded

🔴500Error

Modified at 2026-06-24 15:38:03

Delete template

Order domain