Check availability of several domains

POST

/domains/availability

Check up to 20 domains in one request. Each result has the same fields as the single check (GET /domains/availability/{domain}). A domain that could not be checked gets status error and an error message; the others are still checked. Every domain counts as one availability check: at most 30 per minute per API key or token, shared with the single check, and each counts against the hourly limit of the key.

Request

Authorization

Add parameter in header

API-Key

Example:

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

Header Params

Body Params application/jsonRequired

Example

{
    "domains": [
        "domain.com",
        "domain.nl",
        "domain.shop"
    ]
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://mijn.host/api/v2/domains/availability' \
--header 'Accept: application/json' \
--header 'User-Agent: my-application/1.0.0' \
--header 'API-Key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "domains": [
        "domain.com",
        "domain.nl",
        "domain.shop"
    ]
}'

Responses

🟢200OK

application/json

Bodyapplication/json

Example

{
    "status": 200,
    "status_description": "Request successful",
    "data": {
        "results": [
            {
                "domain": "domain.com",
                "status": "taken",
                "is_premium": false,
                "premium_price": null,
                "has_trustee_available": false,
                "trustee_price": null
            },
            {
                "domain": "domain.nl",
                "status": "available",
                "is_premium": false,
                "premium_price": null,
                "has_trustee_available": false,
                "trustee_price": null
            },
            {
                "domain": "domain",
                "status": "error",
                "error": "Your domain request contains an empty extension"
            }
        ]
    }
}

🟠400Send "domains": an array of domains

🟠400At most 20 domains per request

🟠400Invalid input

🟠400SSL connection is required

🟠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-11-10 10:45:30

Check domain availability

Order domain