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.

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://site.quest/api/v1/domains/pricing \
  -H "Authorization: Bearer sq_live_a94ecfca096d..."

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

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

# Get net prices in USD
curl "https://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.

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.

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://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://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://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.

Register Domain

Register a new domain name. This endpoint creates an order, charges your saved payment method, and initiates domain provisioning. Use the Get Order Status endpoint to track progress.

Required scope: domains:provision

Headers

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

Request Body

Parameter Required Description
domain Yes Full domain name to register (e.g. example.com)
period No Registration period in years (default: 1, max: 10)
nameservers No Array of custom nameservers (max 5). If omitted, Sitequest defaults are used.
whoisPrivacy No Enable WHOIS privacy protection (true or false)

Response

{
  "data": {
    "orderId": "507f1f77bcf86cd799439011",
    "orderToken": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "domain": "example.com",
    "status": "completed",
    "paymentId": "tr_abc123"
  }
}

Response Fields

Field Type Description
orderId string Order ID for tracking
orderToken string Order token (UUID) for tracking
domain string The domain that was registered
status string completed, payment_pending, or payment_failed
paymentId string Mollie payment ID

Status Values

Status Description
completed Payment succeeded, domain is being provisioned
payment_pending Payment initiated (e.g. SEPA direct debit), awaiting confirmation
payment_failed Payment was declined or failed

Prerequisites

Before using this endpoint, ensure:

  1. Your account has completed at least one checkout via the web dashboard (to establish a payment mandate)
  2. You have a valid payment method on file
  3. Your account is not suspended

Error Responses

Status Code Description
400 MISSING_DOMAIN The domain field is required
400 INVALID_DOMAIN Invalid domain format
400 PRICING_UNAVAILABLE TLD is not offered or pricing unavailable
403 account_suspended Account is suspended
403 no_valid_mandate No valid payment method on file
403 no_billing_address Billing address is missing
403 INSUFFICIENT_SCOPE API key lacks domains:provision scope
409 DOMAIN_UNAVAILABLE Domain is not available for registration
409 DUPLICATE_ORDER An identical order is already pending
502 DOMAIN_CHECK_FAILED Could not verify domain availability

Example

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

# Register with custom nameservers and 2-year period
curl -X POST https://site.quest/api/v1/domains/register \
  -H "Authorization: Bearer sq_live_a94ecfca096d..." \
  -H "Content-Type: application/json" \
  -d '{
    "domain": "example.com",
    "period": 2,
    "nameservers": ["ns1.custom.com", "ns2.custom.com"],
    "whoisPrivacy": true
  }'

MCP

This action is also available via the register_domain MCP tool.

Transfer Domain

Transfer an existing domain from another registrar to Sitequest. This endpoint creates an order, charges your saved payment method, and initiates the domain transfer. Use the Get Order Status endpoint to track progress.

Domain transfers typically take 5-7 days to complete depending on the TLD and the current registrar's transfer release process.

Required scope: domains:provision

Headers

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

Request Body

Parameter Required Description
domain Yes Full domain name to transfer (e.g. example.com)
authCode Yes The domain's auth code (transfer key) from the current registrar
period No Registration period in years (default: 1, max: 10)

Response

{
  "data": {
    "orderId": "507f1f77bcf86cd799439011",
    "orderToken": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "domain": "example.com",
    "status": "completed",
    "paymentId": "tr_abc123"
  }
}

Response Fields

Field Type Description
orderId string Order ID for tracking
orderToken string Order token (UUID) for tracking
domain string The domain being transferred
status string completed, payment_pending, or payment_failed
paymentId string Mollie payment ID

Status Values

Status Description
completed Payment succeeded, transfer has been initiated at the registrar
payment_pending Payment initiated (e.g. SEPA direct debit), awaiting confirmation
payment_failed Payment was declined or failed

Prerequisites

Before transferring a domain:

  1. Obtain the auth code from your current registrar
  2. Unlock the domain at the current registrar (disable transfer lock)
  3. Ensure the domain is not within 60 days of registration or a previous transfer (ICANN lock period)
  4. Your Sitequest account must have a valid payment method on file

Error Responses

Status Code Description
400 MISSING_DOMAIN The domain field is required
400 INVALID_DOMAIN Invalid domain format
400 MISSING_AUTHCODE The authCode field is required for transfers
400 PRICING_UNAVAILABLE TLD is not offered or pricing unavailable
403 account_suspended Account is suspended
403 no_valid_mandate No valid payment method on file
403 INSUFFICIENT_SCOPE API key lacks domains:provision scope
409 DUPLICATE_ORDER An identical order is already pending

Example

# Transfer a domain
curl -X POST https://site.quest/api/v1/domains/transfer \
  -H "Authorization: Bearer sq_live_a94ecfca096d..." \
  -H "Content-Type: application/json" \
  -d '{"domain": "example.com", "authCode": "Xy9!kL3mN"}'

# Transfer with 2-year renewal
curl -X POST https://site.quest/api/v1/domains/transfer \
  -H "Authorization: Bearer sq_live_a94ecfca096d..." \
  -H "Content-Type: application/json" \
  -d '{"domain": "example.com", "authCode": "Xy9!kL3mN", "period": 2}'

MCP

This action is also available via the transfer_domain MCP tool.

List Domains

Returns all domains accessible to the authenticated API key.

Required scope: domains:read

Headers

Header Required Value
Authorization Yes Bearer YOUR_API_KEY

Response

{
  "data": [
    {
      "id": "6997649fd6212ab98fbb7289",
      "name": "example.com",
      "tld": "com",
      "sld": "example",
      "status": "OK",
      "terminated": false,
      "autoRenew": true,
      "isLocked": true,
      "isPrivacyEnabled": true,
      "isDnssecEnabled": true,
      "dnsRecordCount": 4,
      "subscription": {
        "cancelledAt": null,
        "expiresAt": null,
        "interval": "12 months"
      },
      "expiresAt": "2027-02-19T19:29:27.000Z",
      "createdAt": "2026-02-19T19:29:35.674Z"
    }
  ]
}

Response Fields

Field Type Description
id string Unique domain identifier
name string Full domain name
tld string Top-level domain (e.g. com, de, io)
sld string Second-level domain (e.g. example)
status string Registration status: OK, LOCK, etc.
terminated boolean Whether the domain is terminated
autoRenew boolean | null Auto-renewal setting
isLocked boolean | null Transfer lock status
isPrivacyEnabled boolean | null WHOIS privacy protection
isDnssecEnabled boolean | null DNSSEC status
dnsRecordCount number Number of DNS records
subscription object | null Subscription status: cancelledAt, expiresAt, interval
expiresAt string | null Expiration date (ISO 8601)
createdAt string Creation timestamp (ISO 8601)

Example

curl https://site.quest/api/v1/domains \
  -H "Authorization: Bearer sq_live_a94ecfca096d..."

MCP

This data is also available via the list_domains MCP tool.

Get Domain

Returns detailed information about a single domain, including DNS records, nameservers, and live registrar data.

Required scope: domains:read

Path Parameters

Parameter Type Description
id string The domain ID

Headers

Header Required Value
Authorization Yes Bearer YOUR_API_KEY

Response

{
  "data": {
    "id": "6997649fd6212ab98fbb7289",
    "name": "example.com",
    "tld": "com",
    "sld": "example",
    "status": "OK",
    "terminated": false,
    "autoRenew": true,
    "isLocked": true,
    "isPrivacyEnabled": true,
    "isDnssecEnabled": true,
    "nameservers": [
      "ns1.openprovider.nl",
      "ns2.openprovider.be",
      "ns3.openprovider.eu"
    ],
    "dnsRecords": [
      {
        "id": "abc123",
        "type": "A",
        "name": "@",
        "value": "45.84.196.79",
        "ttl": 3600,
        "priority": null
      },
      {
        "id": "def456",
        "type": "MX",
        "name": "@",
        "value": "mail.example.com",
        "ttl": 3600,
        "priority": 10
      }
    ],
    "registrar": { ... },
    "subscription": {
      "cancelledAt": null,
      "expiresAt": null,
      "interval": "12 months"
    },
    "expiresAt": "2027-02-19T19:29:27.000Z",
    "createdAt": "2026-02-19T19:29:35.674Z"
  }
}

Response Fields

Field Type Description
id string Unique domain identifier
name string Full domain name
tld string Top-level domain
sld string Second-level domain
status string Registration status
terminated boolean Whether the domain is terminated
autoRenew boolean | null Auto-renewal setting
isLocked boolean | null Transfer lock status
isPrivacyEnabled boolean | null WHOIS privacy protection
isDnssecEnabled boolean | null DNSSEC status
nameservers string[] Active nameservers
dnsRecords array DNS records (see below)
registrar object | null Live registrar data from provider
subscription object | null Subscription status (see below)
expiresAt string | null Expiration date (ISO 8601)
createdAt string Creation timestamp (ISO 8601)

Subscription Fields

Field Type Description
cancelledAt string | null When the subscription was cancelled (ISO 8601), or null if active
expiresAt string | null When the subscription expires (ISO 8601), or null if renewing
interval string | null Billing interval (e.g. "1 month", "12 months")

DNS Record Fields

Field Type Description
id string Record identifier
type string Record type: A, AAAA, CNAME, MX, TXT, NS, SRV, etc.
name string Record name (e.g. @, www, mail)
value string Record value
ttl number Time to live in seconds
priority number | null Priority (MX and SRV records)

Sensitive fields like authcode are stripped from the registrar object.

Errors

Status Code Description
404 NOT_FOUND Domain not found or access denied

Example

curl https://site.quest/api/v1/domains/6997649fd6212ab98fbb7289 \
  -H "Authorization: Bearer sq_live_a94ecfca096d..."

MCP

This data is also available via the get_domain MCP tool.

List DNS Records

Returns all DNS records for a domain. This is a lightweight alternative to the full domain details endpoint when you only need the DNS records.

Required scope: domains:read

Path Parameters

Parameter Type Description
id string The domain ID

Headers

Header Required Value
Authorization Yes Bearer YOUR_API_KEY

Response

{
  "data": [
    {
      "id": "abc123",
      "recordId": 0,
      "type": "A",
      "name": "@",
      "value": "45.84.196.79",
      "ttl": 3600,
      "priority": null
    },
    {
      "id": "def456",
      "recordId": 1,
      "type": "AAAA",
      "name": "@",
      "value": "2a03:4000:64:e8b::1",
      "ttl": 3600,
      "priority": null
    },
    {
      "id": "ghi789",
      "recordId": 2,
      "type": "MX",
      "name": "@",
      "value": "mail.example.com",
      "ttl": 3600,
      "priority": 10
    },
    {
      "id": "jkl012",
      "recordId": 3,
      "type": "TXT",
      "name": "@",
      "value": "v=spf1 include:_spf.google.com ~all",
      "ttl": 3600,
      "priority": null
    }
  ]
}

Record Fields

Field Type Description
id string Record identifier
recordId number | null Provider record ID. Use it for update and delete (/dns/{recordId}). It changes after every write to the zone, so list the records again right before you update or delete one.
type string Record type: A, AAAA, CNAME, ALIAS, MX, TXT, NS, SRV, CAA, TLSA, SSHFP
name string Record name (e.g. @, www, mail, _dmarc)
value string Record value (IP address, hostname, TXT content, etc.)
ttl number Time to live in seconds
priority number | null Priority (used by MX and SRV records)

Errors

Status Code Description
404 NOT_FOUND Domain not found or access denied

Example

curl https://site.quest/api/v1/domains/6997649fd6212ab98fbb7289/dns \
  -H "Authorization: Bearer sq_live_a94ecfca096d..."

MCP

This data is also available via the list_dns_records MCP tool.

Add DNS Record

Add a new DNS record to a domain.

Required scope: domains:manage

Path Parameters

Parameter Type Description
id string The domain ID

Headers

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

Request Body

Field Type Required Description
type string Yes DNS record type. One of: A, AAAA, CNAME, ALIAS, MX, SRV, TXT, CAA, NS, TLSA, SSHFP
name string Yes Record name (e.g. @ for root, www for subdomain)
ttl number Yes Time to live in seconds (minimum 60)
data string Yes Record value (e.g. 1.2.3.4 for an A record)

Response

{
  "data": {
    "success": true
  }
}

Response Fields

Field Type Description
data.success boolean Whether the record was created successfully

Errors

Status Code Description
400 INVALID_TYPE The provided DNS record type is not valid
400 INVALID_NAME The provided record name is not valid
400 INVALID_TTL The provided TTL value is not valid (must be at least 60)
400 INVALID_DATA The provided record data is not valid
404 NOT_FOUND The domain was not found
502 PROVIDER_ERROR The DNS provider returned an error

Example

curl -X POST https://site.quest/api/v1/domains/a1b2c3d4e5f6a1b2c3d4e5f6/dns \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "A",
    "name": "@",
    "ttl": 3600,
    "data": "1.2.3.4"
  }'

MCP

This action is also available via the add_dns_record MCP tool.

Update DNS Record

Update an existing DNS record for a domain.

Required scope: domains:manage

Path Parameters

Parameter Type Description
id string The domain ID
recordId string The DNS record ID

Headers

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

Request Body

Field Type Required Description
data string Yes The new record value

Response

{
  "data": {
    "success": true
  }
}

Response Fields

Field Type Description
data.success boolean Whether the record was updated successfully

Errors

Status Code Description
400 INVALID_RECORD_ID The provided record ID is not valid
400 INVALID_DATA The provided record data is not valid
404 NOT_FOUND The domain was not found
502 PROVIDER_ERROR The DNS provider returned an error

Example

curl -X PUT https://site.quest/api/v1/domains/a1b2c3d4e5f6a1b2c3d4e5f6/dns/12345 \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "data": "5.6.7.8"
  }'

MCP

This action is also available via the edit_dns_record MCP tool.

Delete DNS Record

Delete an existing DNS record from a domain.

Required scope: domains:manage

Path Parameters

Parameter Type Description
id string The domain ID
recordId string The DNS record ID

Headers

Header Required Value
Authorization Yes Bearer YOUR_API_KEY

Response

{
  "data": {
    "success": true
  }
}

Response Fields

Field Type Description
data.success boolean Whether the record was deleted successfully

Errors

Status Code Description
400 INVALID_RECORD_ID The provided record ID is not valid
404 NOT_FOUND The domain was not found
502 PROVIDER_ERROR The DNS provider returned an error

Example

curl -X DELETE https://site.quest/api/v1/domains/a1b2c3d4e5f6a1b2c3d4e5f6/dns/12345 \
  -H "Authorization: Bearer YOUR_API_KEY"

MCP

This action is also available via the delete_dns_record MCP tool.

Update Nameservers

Update the nameservers for a domain.

Required scope: domains:manage

Path Parameters

Parameter Type Description
id string The domain ID

Headers

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

Request Body

Field Type Required Description
ns1 string Yes Primary nameserver
ns2 string Yes Secondary nameserver
ns3 string No Third nameserver
ns4 string No Fourth nameserver
ns5 string No Fifth nameserver

Response

{
  "data": {
    "ns1": "ns1.example.com",
    "ns2": "ns2.example.com",
    "ns3": null,
    "ns4": null,
    "ns5": null
  }
}

Response Fields

Field Type Description
data.ns1 string Primary nameserver
data.ns2 string Secondary nameserver
data.ns3 string | null Third nameserver
data.ns4 string | null Fourth nameserver
data.ns5 string | null Fifth nameserver

Errors

Status Code Description
400 INVALID_NS One or more nameserver values are not valid
404 NOT_FOUND The domain was not found
502 PROVIDER_ERROR The domain provider returned an error

Example

curl -X PUT https://site.quest/api/v1/domains/a1b2c3d4e5f6a1b2c3d4e5f6/nameservers \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "ns1": "ns1.example.com",
    "ns2": "ns2.example.com"
  }'

MCP

This action is also available via the set_nameservers MCP tool.

Transfer Lock

Enable or disable the transfer lock for a domain. When enabled, the domain cannot be transferred to another registrar.

Required scope: domains:manage

Path Parameters

Parameter Type Description
id string The domain ID

Headers

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

Request Body

Field Type Required Description
locked boolean Yes Whether to enable (true) or disable (false) the transfer lock

Response

{
  "data": {
    "locked": true,
    "success": true
  }
}

Response Fields

Field Type Description
data.locked boolean The current transfer lock state
data.success boolean Whether the operation was successful

Errors

Status Code Description
400 INVALID_LOCKED The provided value is not a valid boolean
404 NOT_FOUND The domain was not found
502 PROVIDER_ERROR The domain provider returned an error

Example

curl -X PUT https://site.quest/api/v1/domains/a1b2c3d4e5f6a1b2c3d4e5f6/transfer-lock \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "locked": true
  }'

MCP

This action is also available via the set_transfer_lock MCP tool.

WHOIS Privacy

Enable or disable WHOIS privacy protection for a domain. When enabled, your personal contact information is hidden from public WHOIS lookups.

Required scope: domains:manage

Path Parameters

Parameter Type Description
id string The domain ID

Headers

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

Request Body

Field Type Required Description
enabled boolean Yes Whether to enable (true) or disable (false) WHOIS privacy

Response

{
  "data": {
    "enabled": true,
    "success": true
  }
}

Response Fields

Field Type Description
data.enabled boolean The current WHOIS privacy state
data.success boolean Whether the operation was successful

Errors

Status Code Description
400 INVALID_ENABLED The provided value is not a valid boolean
404 NOT_FOUND The domain was not found
502 PROVIDER_ERROR The domain provider returned an error

Example

curl -X PUT https://site.quest/api/v1/domains/a1b2c3d4e5f6a1b2c3d4e5f6/whois-privacy \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "enabled": true
  }'

MCP

This action is also available via the set_whois_privacy MCP tool.

DNSSEC

Enable or disable DNSSEC (DNS Security Extensions) for a domain. DNSSEC adds a layer of security by digitally signing DNS records.

Required scope: domains:manage

Path Parameters

Parameter Type Description
id string The domain ID

Headers

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

Request Body

Field Type Required Description
enabled boolean Yes Whether to enable (true) or disable (false) DNSSEC

Response

{
  "data": {
    "enabled": true,
    "success": true
  }
}

Response Fields

Field Type Description
data.enabled boolean The current DNSSEC state
data.success boolean Whether the operation was successful

Errors

Status Code Description
400 INVALID_ENABLED The provided value is not a valid boolean
404 NOT_FOUND The domain was not found
502 PROVIDER_ERROR The domain provider returned an error

Example

curl -X PUT https://site.quest/api/v1/domains/a1b2c3d4e5f6a1b2c3d4e5f6/dnssec \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "enabled": true
  }'

MCP

This action is also available via the set_dnssec MCP tool.

Get Authcode

Retrieve the authorization code (authcode) for a domain. The authcode is required to transfer a domain to another registrar.

Required scope: domains:manage (domain owner only)

Path Parameters

Parameter Type Description
id string The domain ID

Headers

Header Required Value
Authorization Yes Bearer YOUR_API_KEY

Response

{
  "data": {
    "authcode": "aBc123xYz"
  }
}

Response Fields

Field Type Description
data.authcode string The domain authorization code

Errors

Status Code Description
404 NOT_FOUND The domain was not found
502 PROVIDER_ERROR The domain provider returned an error

Example

curl -X GET https://site.quest/api/v1/domains/a1b2c3d4e5f6a1b2c3d4e5f6/authcode \
  -H "Authorization: Bearer YOUR_API_KEY"

MCP

This action is also available via the get_authcode MCP tool.

Get Order Status

Retrieve the current status and details of an order by its ID or token. Use this to poll for fulfillment progress after placing an order via the API or MCP.

The :id parameter accepts either the order ID (MongoDB ObjectId) or the order token (UUID).

Headers

Header Required Value
Authorization Yes Bearer YOUR_API_KEY

Required Scope

  • vps:provision for new VPS orders, vps:scale for VPS upgrades
  • webspace:provision for new webspace orders, webspace:scale for webspace upgrades
  • domains:provision for domain orders

Response

{
  "data": {
    "id": "507f1f77bcf86cd799439011",
    "token": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "status": "COMPLETED",
    "type": "DOMAIN",
    "channel": "api",
    "totalNet": 0.00,
    "totalGross": 0.00,
    "currency": "EUR",
    "interval": "12 months",
    "provisionedResourceId": "507f1f77bcf86cd799439022",
    "provisionedAt": "2026-03-29T12:00:00.000Z",
    "createdAt": "2026-03-29T11:59:00.000Z",
    "updatedAt": "2026-03-29T12:00:00.000Z"
  }
}

Response Fields

Field Type Description
id string Order ID
token string Order token (UUID)
status string Current status (see below)
type string Order type: VM or DOMAIN
channel string Origin channel: shop, api, or mcp
totalNet number Net price (excluding VAT)
totalGross number Gross price (including VAT)
currency string Currency code (EUR)
interval string Billing interval (e.g. 1 month, 12 months)
provisionedResourceId string|null ID of the provisioned VPS or domain (set after fulfillment)
provisionedAt string|null ISO 8601 timestamp of when provisioning completed
createdAt string ISO 8601 timestamp of order creation
updatedAt string ISO 8601 timestamp of last update

Order Statuses

Status Description
PENDING Payment initiated, awaiting confirmation
PROCESSING Payment confirmed, provisioning in progress
COMPLETED Fully provisioned and active
FAILED Payment failed
CANCELED Order was canceled
PROVISION_FAILED Payment succeeded but provisioning failed (refund issued)
EXPIRED Order expired before payment

Error Responses

Status Code Description
404 NOT_FOUND Order not found or does not belong to the authenticated user
403 INSUFFICIENT_SCOPE API key lacks the scope required for this order type

Example

# Get order by ID
curl https://site.quest/api/v1/orders/507f1f77bcf86cd799439011 \
  -H "Authorization: Bearer sq_live_a94ecfca096d..."

# Get order by token
curl https://site.quest/api/v1/orders/a1b2c3d4-e5f6-7890-abcd-ef1234567890 \
  -H "Authorization: Bearer sq_live_a94ecfca096d..."

MCP

This data is also available via the get_order_status MCP tool.

Cancel Domain

Cancel a domain subscription at the end of the current billing period. The domain stays active until the expiry date, and auto-renew is disabled at the registrar.

Required scope: domains:cancel

Path Parameters

Parameter Type Description
id string The domain ID

Headers

Header Required Value
Authorization Yes Bearer YOUR_API_KEY

Response

{
  "data": {
    "id": "507f1f77bcf86cd799439011",
    "name": "example.com",
    "cancelled": true,
    "expiresAt": "2026-04-15T00:00:00.000Z"
  }
}

Response Fields

Field Type Description
id string The domain ID
name string The domain name
cancelled boolean Always true after successful cancellation
expiresAt string ISO 8601 date when the domain subscription will expire

Error Responses

Status Code Description
400 NO_SUBSCRIPTION No active subscription found for this domain
400 CANCEL_FAILED Failed to cancel the subscription
403 INSUFFICIENT_SCOPE API key lacks domains:cancel scope
404 NOT_FOUND Domain not found or you do not have owner access

Example

curl -X POST https://site.quest/api/v1/domains/507f1f77bcf86cd799439011/cancel \
  -H "Authorization: Bearer sq_live_a94ecfca096d..."

Reactivation

To reactivate a cancelled domain before the expiry date, use the Reactivate Domain endpoint.

MCP

This action is also available via the cancel_domain MCP tool.

Reactivate Domain

Reactivate a cancelled domain subscription before the expiry date. This creates a new recurring subscription and clears the cancellation, so the domain continues to renew normally.

Required scope: domains:cancel

Path Parameters

Parameter Type Description
id string The domain ID

Headers

Header Required Value
Authorization Yes Bearer YOUR_API_KEY

Response

{
  "data": {
    "id": "507f1f77bcf86cd799439011",
    "name": "example.com",
    "reactivated": true
  }
}

Response Fields

Field Type Description
id string The domain ID
name string The domain name
reactivated boolean Always true after successful reactivation

Error Responses

Status Code Description
400 NOT_CANCELLED No cancelled subscription found for this domain
400 UNCANCEL_FAILED Failed to reactivate the subscription
403 INSUFFICIENT_SCOPE API key lacks domains:cancel scope
404 NOT_FOUND Domain not found or you do not have owner access

Example

curl -X POST https://site.quest/api/v1/domains/507f1f77bcf86cd799439011/uncancel \
  -H "Authorization: Bearer sq_live_a94ecfca096d..."

MCP

This action is also available via the uncancel_domain MCP tool.