API Documentation

Domain Pricing

Returns all available TLDs and their registration prices. Optionally filter by a single TLD using the tld query parameter, or check a specific domain with domain to get availability and premium pricing info. Prices are returned as gross EUR by default; use currency and display to customise.

Request

GET /api/v1/domains/pricing
GET /api/v1/domains/pricing?tld=com
GET /api/v1/domains/pricing?domain=example.com
GET /api/v1/domains/pricing?currency=USD&display=net

Headers

Header Required Value
Authorization Yes Bearer YOUR_API_KEY

Query Parameters

Parameter Required Description
tld No Filter by a specific TLD (e.g. com, de, io)
domain No Full domain name to check availability and premium fee (e.g. example.com)
currency No Price currency: EUR (default) or USD
display No Price display mode: gross (default) or net (excluding VAT)

Response (List)

{
  "data": [
    { "tld": "com", "price": 0.00 },
    { "tld": "de", "price": 0.00 },
    { "tld": "io", "price": 0.00 }
  ],
  "currency": "EUR",
  "display": "gross",
  "count": 3
}

Response (Single TLD)

When the tld parameter is provided:

{
  "data": {
    "tld": "com",
    "price": 0.00
  },
  "currency": "EUR",
  "display": "gross"
}

Returns 404 if the TLD is not available.

Response (Domain Check)

When the domain parameter is provided, additionally checks availability and premium status:

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

For premium domains, premium and premiumFee are included:

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

Response Fields

Field Type Description
tld string Top-level domain (e.g. com, de, io)
price number Standard registration price per year
domain string Full domain name (domain check only)
available boolean Whether the domain is available for registration (domain check only)
premium boolean Whether this is a premium domain with elevated pricing (domain check only, present when true)
premiumFee number Premium registration fee per year (domain check only, present for premium domains)
currency string Currency code (EUR or USD)
display string Display mode (gross or net)
count number Total number of available TLDs (list only)

Example

# List all TLDs
curl https://hosting.site.quest/api/v1/domains/pricing \
  -H "Authorization: Bearer sq_live_a94ecfca096d..."

# Look up a single TLD
curl "https://hosting.site.quest/api/v1/domains/pricing?tld=com" \
  -H "Authorization: Bearer sq_live_a94ecfca096d..."

# Check a specific domain (availability + premium)
curl "https://hosting.site.quest/api/v1/domains/pricing?domain=example.com" \
  -H "Authorization: Bearer sq_live_a94ecfca096d..."

# Get net prices in USD
curl "https://hosting.site.quest/api/v1/domains/pricing?currency=USD&display=net" \
  -H "Authorization: Bearer sq_live_a94ecfca096d..."

MCP

This data is also available via the get_domain_pricing MCP tool.