API Documentation

Domain Availability Check

Check whether a domain is available for registration. Supports checking a single domain or a base name across multiple TLDs in one request. Returns availability status, premium info, and pricing.

Request

POST /api/v1/domains/check

Headers

Header Required Value
Authorization Yes Bearer YOUR_API_KEY
Content-Type Yes application/json

Body Parameters

Parameter Required Description
domain Yes Full domain name (e.g. example.com) or base name when using tlds (e.g. example)
tlds No Array of TLDs to check (e.g. ["com", "de", "io"]). When provided, domain is treated as the base name. Max 20.
currency No Price currency: EUR (default) or USD
display No Price display mode: gross (default) or net (excluding VAT)

Response (Single Domain)

{
  "data": {
    "domain": "example.com",
    "tld": "com",
    "available": true,
    "price": 0.00
  },
  "currency": "EUR",
  "display": "gross"
}

For premium domains, premium and premiumFee are included:

{
  "data": {
    "domain": "crypto.com",
    "tld": "com",
    "available": false,
    "premium": true,
    "premiumFee": 0.00,
    "price": 0.00
  },
  "currency": "EUR",
  "display": "gross"
}

Response (Multi-TLD)

When tlds is provided, results for all requested TLDs are returned:

{
  "data": [
    { "domain": "example.com", "tld": "com", "available": true, "price": 0.00 },
    { "domain": "example.de", "tld": "de", "available": true, "price": 0.00 },
    { "domain": "example.io", "tld": "io", "available": false, "price": 0.00 }
  ],
  "currency": "EUR",
  "display": "gross"
}

Response Fields

Field Type Description
domain string Full domain name that was checked
tld string Top-level domain (e.g. com, de)
available boolean Whether the domain is available for registration
price number Standard registration price per year (present when the TLD is offered)
premium boolean Whether this is a premium domain (present when true)
premiumFee number Premium registration fee per year (present for premium domains)
currency string Currency code (EUR or USD)
display string Display mode (gross or net)

Example

# Check a single domain
curl -X POST https://hosting.site.quest/api/v1/domains/check \
  -H "Authorization: Bearer sq_live_a94ecfca096d..." \
  -H "Content-Type: application/json" \
  -d '{"domain": "example.com"}'

# Check a base name across multiple TLDs
curl -X POST https://hosting.site.quest/api/v1/domains/check \
  -H "Authorization: Bearer sq_live_a94ecfca096d..." \
  -H "Content-Type: application/json" \
  -d '{"domain": "example", "tlds": ["com", "de", "io", "net", "org"]}'

# Check with USD net prices
curl -X POST https://hosting.site.quest/api/v1/domains/check \
  -H "Authorization: Bearer sq_live_a94ecfca096d..." \
  -H "Content-Type: application/json" \
  -d '{"domain": "example.com", "currency": "USD", "display": "net"}'

MCP

This action is also available via the check_domain MCP tool.