API-Dokumentation

Domain-Preise

Gibt alle verfügbaren TLDs und deren Registrierungspreise zurück. Optional kann über den tld-Abfrageparameter nach einer einzelnen TLD gefiltert werden, oder verwende domain, um eine bestimmte Domain auf Verfügbarkeit und Premium-Preise zu prüfen. Preise werden standardmäßig als Bruttopreise in EUR zurückgegeben; verwende currency und display zur Anpassung.

Header

Header Erforderlich Wert
Authorization Ja Bearer DEIN_API_SCHLÜSSEL

Abfrageparameter

Parameter Erforderlich Beschreibung
tld Nein Nach einer bestimmten TLD filtern (z.B. com, de, io)
domain Nein Vollständiger Domainname zur Prüfung auf Verfügbarkeit und Premium-Gebühr (z.B. example.com)
currency Nein Preiswährung: EUR (Standard) oder USD
display Nein Preisanzeige: gross (Standard, Brutto) oder net (Netto, ohne MwSt.)

Antwort (Liste)

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

Antwort (Einzelne TLD)

Wenn der tld-Parameter angegeben wird:

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

Gibt 404 zurück, wenn die TLD nicht verfügbar ist.

Antwort (Domain-Prüfung)

Wenn der domain-Parameter angegeben wird, werden zusätzlich Verfügbarkeit und Premium-Status geprüft:

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

Bei Premium-Domains werden premium und premiumFee mitgeliefert:

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

Antwortfelder

Feld Typ Beschreibung
tld string Top-Level-Domain (z.B. com, de, io)
price number Standard-Registrierungspreis pro Jahr
domain string Vollständiger Domainname (nur bei Domain-Prüfung)
available boolean Ob die Domain zur Registrierung verfügbar ist (nur bei Domain-Prüfung)
premium boolean Ob es sich um eine Premium-Domain mit erhöhtem Preis handelt (nur bei Domain-Prüfung, vorhanden wenn zutreffend)
premiumFee number Premium-Registrierungsgebühr pro Jahr (nur bei Domain-Prüfung, vorhanden bei Premium-Domains)
currency string Währungscode (EUR oder USD)
display string Anzeigemodus (gross oder net)
count number Gesamtanzahl der verfügbaren TLDs (nur bei Liste)

Beispiel

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

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

# Bestimmte Domain prüfen (Verfügbarkeit + Premium)
curl "https://site.quest/api/v1/domains/pricing?domain=example.com" \
  -H "Authorization: Bearer sq_live_a94ecfca096d..."

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

MCP

Diese Daten sind auch über das MCP-Tool get_domain_pricing verfügbar.

Domain-Verfügbarkeit prüfen

Prüfe, ob eine Domain zur Registrierung verfügbar ist. Unterstützt die Prüfung einer einzelnen Domain oder eines Basisnamens über mehrere TLDs in einer Anfrage. Gibt Verfügbarkeitsstatus, Premium-Infos und Preise zurück.

Header

Header Erforderlich Wert
Authorization Ja Bearer DEIN_API_SCHLÜSSEL
Content-Type Ja application/json

Body-Parameter

Parameter Erforderlich Beschreibung
domain Ja Vollständiger Domainname (z.B. example.com) oder Basisname bei Verwendung von tlds (z.B. example)
tlds Nein Array von TLDs zur Prüfung (z.B. ["com", "de", "io"]). Wenn angegeben, wird domain als Basisname behandelt. Max. 20.
currency Nein Preiswährung: EUR (Standard) oder USD
display Nein Preisanzeige: gross (Standard, Brutto) oder net (Netto, ohne MwSt.)

Antwort (Einzelne Domain)

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

Bei Premium-Domains werden premium und premiumFee mitgeliefert:

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

Antwort (Multi-TLD)

Wenn tlds angegeben wird, werden Ergebnisse für alle angeforderten TLDs zurückgegeben:

{
  "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"
}

Antwortfelder

Feld Typ Beschreibung
domain string Vollständiger Domainname, der geprüft wurde
tld string Top-Level-Domain (z.B. com, de)
available boolean Ob die Domain zur Registrierung verfügbar ist
price number Standard-Registrierungspreis pro Jahr (vorhanden, wenn die TLD angeboten wird)
premium boolean Ob es sich um eine Premium-Domain handelt (vorhanden wenn zutreffend)
premiumFee number Premium-Registrierungsgebühr pro Jahr (vorhanden bei Premium-Domains)
currency string Währungscode (EUR oder USD)
display string Anzeigemodus (gross oder net)

Beispiel

# Einzelne Domain prüfen
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"}'

# Basisname über mehrere TLDs prüfen
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"]}'

# Mit USD-Nettopreisen prüfen
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

Diese Aktion ist auch über das check_domain MCP-Tool verfügbar.

Domain registrieren

Registriere einen neuen Domainnamen. Dieser Endpunkt erstellt eine Bestellung, belastet deine gespeicherte Zahlungsmethode und startet die Domain-Bereitstellung. Verwende den Bestellstatus-Endpunkt, um den Fortschritt zu verfolgen.

Erforderlicher Scope: domains:provision

Header

Header Erforderlich Wert
Authorization Ja Bearer DEIN_API_SCHLÜSSEL
Content-Type Ja application/json

Anfragekörper

Parameter Erforderlich Beschreibung
domain Ja Vollständiger Domainname (z.B. example.com)
period Nein Registrierungszeitraum in Jahren (Standard: 1, max: 10)
nameservers Nein Array benutzerdefinierter Nameserver (max 5). Wenn nicht angegeben, werden Sitequest-Standards verwendet.
whoisPrivacy Nein WHOIS-Datenschutz aktivieren (true oder false)

Antwort

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

Antwortfelder

Feld Typ Beschreibung
orderId string Bestell-ID zur Nachverfolgung
orderToken string Bestell-Token (UUID) zur Nachverfolgung
domain string Die registrierte Domain
status string completed, payment_pending oder payment_failed
paymentId string Mollie-Zahlungs-ID

Statuswerte

Status Beschreibung
completed Zahlung erfolgreich, Domain wird bereitgestellt
payment_pending Zahlung eingeleitet (z.B. SEPA-Lastschrift), warte auf Bestätigung
payment_failed Zahlung wurde abgelehnt oder ist fehlgeschlagen

Voraussetzungen

Stelle vor der Nutzung dieses Endpunkts sicher, dass:

  1. Dein Konto mindestens einen Checkout über das Web-Dashboard abgeschlossen hat (um ein Zahlungsmandat einzurichten)
  2. Du eine gültige Zahlungsmethode hinterlegt hast
  3. Dein Konto nicht gesperrt ist

Fehlerantworten

Status Code Beschreibung
400 MISSING_DOMAIN Das Feld domain ist erforderlich
400 INVALID_DOMAIN Ungültiges Domain-Format
400 PRICING_UNAVAILABLE TLD wird nicht angeboten oder Preise nicht verfügbar
403 account_suspended Konto ist gesperrt
403 no_valid_mandate Keine gültige Zahlungsmethode hinterlegt
403 no_billing_address Rechnungsadresse fehlt
403 INSUFFICIENT_SCOPE API-Schlüssel hat nicht den erforderlichen domains:provision-Scope
409 DOMAIN_UNAVAILABLE Domain ist nicht zur Registrierung verfügbar
409 DUPLICATE_ORDER Eine identische Bestellung ist bereits ausstehend
502 DOMAIN_CHECK_FAILED Domain-Verfügbarkeit konnte nicht überprüft werden

Beispiel

# Domain registrieren
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"}'

# Registrierung mit benutzerdefinierten Nameservern und 2-Jahres-Zeitraum
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

Diese Aktion ist auch über das register_domain MCP-Tool verfügbar.

Domain transferieren

Transferiere eine bestehende Domain von einem anderen Registrar zu Sitequest. Dieser Endpunkt erstellt eine Bestellung, belastet deine gespeicherte Zahlungsmethode und leitet den Domain-Transfer ein. Verwende den Bestellstatus-Endpunkt, um den Fortschritt zu verfolgen.

Domain-Transfers dauern in der Regel 5-7 Tage, abhängig von der TLD und dem Transfer-Freigabeprozess des aktuellen Registrars.

Erforderlicher Scope: domains:provision

Header

Header Erforderlich Wert
Authorization Ja Bearer DEIN_API_SCHLÜSSEL
Content-Type Ja application/json

Anfragekörper

Parameter Erforderlich Beschreibung
domain Ja Vollständiger Domainname zum Transferieren (z.B. example.com)
authCode Ja Der Auth-Code (Transferschlüssel) der Domain vom aktuellen Registrar
period Nein Registrierungszeitraum in Jahren (Standard: 1, max: 10)

Antwort

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

Antwortfelder

Feld Typ Beschreibung
orderId string Bestell-ID zur Nachverfolgung
orderToken string Bestell-Token (UUID) zur Nachverfolgung
domain string Die zu transferierende Domain
status string completed, payment_pending oder payment_failed
paymentId string Mollie-Zahlungs-ID

Statuswerte

Status Beschreibung
completed Zahlung erfolgreich, Transfer wurde beim Registrar eingeleitet
payment_pending Zahlung eingeleitet (z.B. SEPA-Lastschrift), warte auf Bestätigung
payment_failed Zahlung wurde abgelehnt oder ist fehlgeschlagen

Voraussetzungen

Vor dem Transfer einer Domain:

  1. Auth-Code vom aktuellen Registrar anfordern
  2. Domain beim aktuellen Registrar entsperren (Transfer-Lock deaktivieren)
  3. Sicherstellen, dass die Domain nicht innerhalb von 60 Tagen nach Registrierung oder einem vorherigen Transfer steht (ICANN-Sperrfrist)
  4. Dein Sitequest-Konto muss eine gültige Zahlungsmethode hinterlegt haben

Fehlerantworten

Status Code Beschreibung
400 MISSING_DOMAIN Das Feld domain ist erforderlich
400 INVALID_DOMAIN Ungültiges Domain-Format
400 MISSING_AUTHCODE Das Feld authCode ist für Transfers erforderlich
400 PRICING_UNAVAILABLE TLD wird nicht angeboten oder Preise nicht verfügbar
403 account_suspended Konto ist gesperrt
403 no_valid_mandate Keine gültige Zahlungsmethode hinterlegt
403 INSUFFICIENT_SCOPE API-Schlüssel hat nicht den erforderlichen domains:provision-Scope
409 DUPLICATE_ORDER Eine identische Bestellung ist bereits ausstehend

Beispiel

# Domain transferieren
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 mit 2-Jahres-Verlängerung
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

Diese Aktion ist auch über das transfer_domain MCP-Tool verfügbar.

Domains auflisten

Gibt alle Domains zurück, auf die der authentifizierte API-Schlüssel Zugriff hat.

Erforderlicher Scope: domains:read

Header

Header Erforderlich Wert
Authorization Ja Bearer DEIN_API_SCHLÜSSEL

Antwort

{
  "data": [
    {
      "id": "6997649fd6212ab98fbb7289",
      "name": "beispiel.de",
      "tld": "de",
      "sld": "beispiel",
      "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"
    }
  ]
}

Antwortfelder

Feld Typ Beschreibung
id string Eindeutige Domain-ID
name string Vollständiger Domainname
tld string Top-Level-Domain (z.B. com, de, io)
sld string Second-Level-Domain (z.B. beispiel)
status string Registrierungsstatus: OK, LOCK usw.
terminated boolean Ob die Domain gekündigt ist
autoRenew boolean | null Automatische Verlängerung
isLocked boolean | null Transfer-Sperre
isPrivacyEnabled boolean | null WHOIS-Datenschutz
isDnssecEnabled boolean | null DNSSEC-Status
dnsRecordCount number Anzahl der DNS-Einträge
subscription object | null Abonnement-Status: cancelledAt, expiresAt, interval
expiresAt string | null Ablaufdatum (ISO 8601)
createdAt string Erstellungszeitstempel (ISO 8601)

Beispiel

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

MCP

Diese Daten sind auch über das list_domains MCP-Tool verfügbar.

Domain abrufen

Gibt detaillierte Informationen über eine einzelne Domain zurück, einschließlich DNS-Einträge, Nameserver und Live-Daten vom Registrar.

Erforderlicher Scope: domains:read

Pfadparameter

Parameter Typ Beschreibung
id string Die Domain-ID

Header

Header Erforderlich Wert
Authorization Ja Bearer DEIN_API_SCHLÜSSEL

Antwort

{
  "data": {
    "id": "6997649fd6212ab98fbb7289",
    "name": "beispiel.de",
    "tld": "de",
    "sld": "beispiel",
    "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.beispiel.de",
        "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"
  }
}

Antwortfelder

Feld Typ Beschreibung
id string Eindeutige Domain-ID
name string Vollständiger Domainname
tld string Top-Level-Domain
sld string Second-Level-Domain
status string Registrierungsstatus
terminated boolean Ob die Domain gekündigt ist
autoRenew boolean | null Automatische Verlängerung
isLocked boolean | null Transfer-Sperre
isPrivacyEnabled boolean | null WHOIS-Datenschutz
isDnssecEnabled boolean | null DNSSEC-Status
nameservers string[] Aktive Nameserver
dnsRecords array DNS-Einträge (siehe unten)
registrar object | null Live-Registrar-Daten vom Provider
subscription object | null Abonnement-Status (siehe unten)
expiresAt string | null Ablaufdatum (ISO 8601)
createdAt string Erstellungszeitstempel (ISO 8601)

Abonnement-Felder

Feld Typ Beschreibung
cancelledAt string | null Wann das Abonnement gekündigt wurde (ISO 8601), oder null wenn aktiv
expiresAt string | null Wann das Abonnement abläuft (ISO 8601), oder null wenn es verlängert wird
interval string | null Abrechnungsintervall (z.B. "1 month", "12 months")

DNS-Eintragsfelder

Feld Typ Beschreibung
id string Eintrags-ID
type string Eintragstyp: A, AAAA, CNAME, MX, TXT, NS, SRV usw.
name string Eintragsname (z.B. @, www, mail)
value string Eintragswert
ttl number Time to Live in Sekunden
priority number | null Priorität (MX- und SRV-Einträge)

Sensible Felder wie authcode werden aus dem registrar-Objekt entfernt.

Fehler

Status Code Beschreibung
404 NOT_FOUND Domain nicht gefunden oder kein Zugriff

Beispiel

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

MCP

Diese Daten sind auch über das get_domain MCP-Tool verfügbar.

DNS-Einträge auflisten

Gibt alle DNS-Einträge einer Domain zurück. Dies ist eine schlanke Alternative zum vollständigen Domain-Details-Endpunkt, wenn du nur die DNS-Einträge brauchst.

Erforderlicher Scope: domains:read

Pfadparameter

Parameter Typ Beschreibung
id string Die Domain-ID

Header

Header Erforderlich Wert
Authorization Ja Bearer DEIN_API_SCHLÜSSEL

Antwort

{
  "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
    }
  ]
}

Eintrag-Felder

Feld Typ Beschreibung
id string Eintrags-ID
recordId number | null Eintrags-ID beim DNS-Anbieter. Brauchst du zum Ändern und Löschen (/dns/{recordId}). Sie ändert sich nach jeder Änderung an der Zone, also liste die Einträge direkt vorher neu ab.
type string Eintragstyp: A, AAAA, CNAME, ALIAS, MX, TXT, NS, SRV, CAA, TLSA, SSHFP
name string Eintragsname (z.B. @, www, mail, _dmarc)
value string Eintragswert (IP-Adresse, Hostname, TXT-Inhalt usw.)
ttl number Time to Live in Sekunden
priority number | null Priorität (für MX- und SRV-Einträge)

Fehler

Status Code Beschreibung
404 NOT_FOUND Domain nicht gefunden oder kein Zugriff

Beispiel

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

MCP

Diese Daten sind auch über das MCP-Tool list_dns_records verfügbar.

DNS-Eintrag hinzufügen

Fügt einen neuen DNS-Eintrag zu einer Domain hinzu.

Erforderlicher Scope: domains:manage

Pfadparameter

Parameter Typ Beschreibung
id string Die Domain-ID

Header

Header Erforderlich Wert
Authorization Ja Bearer DEIN_API_SCHLÜSSEL
Content-Type Ja application/json

Anfragekörper

Feld Typ Erforderlich Beschreibung
type string Ja DNS-Eintragstyp. Einer von: A, AAAA, CNAME, ALIAS, MX, SRV, TXT, CAA, NS, TLSA, SSHFP
name string Ja Eintragsname (z.B. @ für Root, www für Subdomain)
ttl number Ja Time to Live in Sekunden (Minimum 60)
data string Ja Eintragswert (z.B. 1.2.3.4 für einen A-Eintrag)

Antwort

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

Antwortfelder

Feld Typ Beschreibung
data.success boolean Ob der Eintrag erfolgreich erstellt wurde

Fehler

Status Code Beschreibung
400 INVALID_TYPE Der angegebene DNS-Eintragstyp ist ungültig
400 INVALID_NAME Der angegebene Eintragsname ist ungültig
400 INVALID_TTL Der angegebene TTL-Wert ist ungültig (muss mindestens 60 sein)
400 INVALID_DATA Die angegebenen Eintragsdaten sind ungültig
404 NOT_FOUND Die Domain wurde nicht gefunden
502 PROVIDER_ERROR Der DNS-Provider hat einen Fehler zurückgegeben

Beispiel

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

MCP

Diese Aktion ist auch über das add_dns_record MCP-Tool verfügbar.

DNS-Eintrag aktualisieren

Aktualisiert einen bestehenden DNS-Eintrag für eine Domain.

Erforderlicher Scope: domains:manage

Pfadparameter

Parameter Typ Beschreibung
id string Die Domain-ID
recordId string Die DNS-Eintrags-ID

Header

Header Erforderlich Wert
Authorization Ja Bearer DEIN_API_SCHLÜSSEL
Content-Type Ja application/json

Anfragekörper

Feld Typ Erforderlich Beschreibung
data string Ja Der neue Eintragswert

Antwort

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

Antwortfelder

Feld Typ Beschreibung
data.success boolean Ob der Eintrag erfolgreich aktualisiert wurde

Fehler

Status Code Beschreibung
400 INVALID_RECORD_ID Die angegebene Eintrags-ID ist ungültig
400 INVALID_DATA Die angegebenen Eintragsdaten sind ungültig
404 NOT_FOUND Die Domain wurde nicht gefunden
502 PROVIDER_ERROR Der DNS-Provider hat einen Fehler zurückgegeben

Beispiel

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

MCP

Diese Aktion ist auch über das edit_dns_record MCP-Tool verfügbar.

DNS-Eintrag löschen

Löscht einen bestehenden DNS-Eintrag von einer Domain.

Erforderlicher Scope: domains:manage

Pfadparameter

Parameter Typ Beschreibung
id string Die Domain-ID
recordId string Die DNS-Eintrags-ID

Header

Header Erforderlich Wert
Authorization Ja Bearer DEIN_API_SCHLÜSSEL

Antwort

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

Antwortfelder

Feld Typ Beschreibung
data.success boolean Ob der Eintrag erfolgreich gelöscht wurde

Fehler

Status Code Beschreibung
400 INVALID_RECORD_ID Die angegebene Eintrags-ID ist ungültig
404 NOT_FOUND Die Domain wurde nicht gefunden
502 PROVIDER_ERROR Der DNS-Provider hat einen Fehler zurückgegeben

Beispiel

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

MCP

Diese Aktion ist auch über das delete_dns_record MCP-Tool verfügbar.

Nameserver aktualisieren

Aktualisiert die Nameserver für eine Domain.

Erforderlicher Scope: domains:manage

Pfadparameter

Parameter Typ Beschreibung
id string Die Domain-ID

Header

Header Erforderlich Wert
Authorization Ja Bearer DEIN_API_SCHLÜSSEL
Content-Type Ja application/json

Anfragekörper

Feld Typ Erforderlich Beschreibung
ns1 string Ja Primärer Nameserver
ns2 string Ja Sekundärer Nameserver
ns3 string Nein Dritter Nameserver
ns4 string Nein Vierter Nameserver
ns5 string Nein Fünfter Nameserver

Antwort

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

Antwortfelder

Feld Typ Beschreibung
data.ns1 string Primärer Nameserver
data.ns2 string Sekundärer Nameserver
data.ns3 string | null Dritter Nameserver
data.ns4 string | null Vierter Nameserver
data.ns5 string | null Fünfter Nameserver

Fehler

Status Code Beschreibung
400 INVALID_NS Einer oder mehrere Nameserver-Werte sind ungültig
404 NOT_FOUND Die Domain wurde nicht gefunden
502 PROVIDER_ERROR Der Domain-Provider hat einen Fehler zurückgegeben

Beispiel

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

MCP

Diese Aktion ist auch über das set_nameservers MCP-Tool verfügbar.

Transfer-Sperre

Aktiviert oder deaktiviert die Transfer-Sperre für eine Domain. Wenn aktiviert, kann die Domain nicht zu einem anderen Registrar übertragen werden.

Erforderlicher Scope: domains:manage

Pfadparameter

Parameter Typ Beschreibung
id string Die Domain-ID

Header

Header Erforderlich Wert
Authorization Ja Bearer DEIN_API_SCHLÜSSEL
Content-Type Ja application/json

Anfragekörper

Feld Typ Erforderlich Beschreibung
locked boolean Ja Ob die Transfer-Sperre aktiviert (true) oder deaktiviert (false) werden soll

Antwort

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

Antwortfelder

Feld Typ Beschreibung
data.locked boolean Der aktuelle Transfer-Sperre-Status
data.success boolean Ob die Operation erfolgreich war

Fehler

Status Code Beschreibung
400 INVALID_LOCKED Der angegebene Wert ist kein gültiger Boolean
404 NOT_FOUND Die Domain wurde nicht gefunden
502 PROVIDER_ERROR Der Domain-Provider hat einen Fehler zurückgegeben

Beispiel

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

MCP

Diese Aktion ist auch über das set_transfer_lock MCP-Tool verfügbar.

WHOIS-Datenschutz

Aktiviert oder deaktiviert den WHOIS-Datenschutz für eine Domain. Wenn aktiviert, werden deine persönlichen Kontaktdaten in öffentlichen WHOIS-Abfragen verborgen.

Erforderlicher Scope: domains:manage

Pfadparameter

Parameter Typ Beschreibung
id string Die Domain-ID

Header

Header Erforderlich Wert
Authorization Ja Bearer DEIN_API_SCHLÜSSEL
Content-Type Ja application/json

Anfragekörper

Feld Typ Erforderlich Beschreibung
enabled boolean Ja Ob der WHOIS-Datenschutz aktiviert (true) oder deaktiviert (false) werden soll

Antwort

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

Antwortfelder

Feld Typ Beschreibung
data.enabled boolean Der aktuelle WHOIS-Datenschutz-Status
data.success boolean Ob die Operation erfolgreich war

Fehler

Status Code Beschreibung
400 INVALID_ENABLED Der angegebene Wert ist kein gültiger Boolean
404 NOT_FOUND Die Domain wurde nicht gefunden
502 PROVIDER_ERROR Der Domain-Provider hat einen Fehler zurückgegeben

Beispiel

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

MCP

Diese Aktion ist auch über das set_whois_privacy MCP-Tool verfügbar.

DNSSEC

Aktiviert oder deaktiviert DNSSEC (DNS Security Extensions) für eine Domain. DNSSEC fügt eine zusätzliche Sicherheitsebene hinzu, indem DNS-Einträge digital signiert werden.

Erforderlicher Scope: domains:manage

Pfadparameter

Parameter Typ Beschreibung
id string Die Domain-ID

Header

Header Erforderlich Wert
Authorization Ja Bearer DEIN_API_SCHLÜSSEL
Content-Type Ja application/json

Anfragekörper

Feld Typ Erforderlich Beschreibung
enabled boolean Ja Ob DNSSEC aktiviert (true) oder deaktiviert (false) werden soll

Antwort

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

Antwortfelder

Feld Typ Beschreibung
data.enabled boolean Der aktuelle DNSSEC-Status
data.success boolean Ob die Operation erfolgreich war

Fehler

Status Code Beschreibung
400 INVALID_ENABLED Der angegebene Wert ist kein gültiger Boolean
404 NOT_FOUND Die Domain wurde nicht gefunden
502 PROVIDER_ERROR Der Domain-Provider hat einen Fehler zurückgegeben

Beispiel

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

MCP

Diese Aktion ist auch über das set_dnssec MCP-Tool verfügbar.

Authcode abrufen

Ruft den Autorisierungscode (Authcode) für eine Domain ab. Der Authcode wird benötigt, um eine Domain zu einem anderen Registrar zu übertragen.

Erforderlicher Scope: domains:manage (nur für den Domain-Inhaber)

Pfadparameter

Parameter Typ Beschreibung
id string Die Domain-ID

Header

Header Erforderlich Wert
Authorization Ja Bearer DEIN_API_SCHLÜSSEL

Antwort

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

Antwortfelder

Feld Typ Beschreibung
data.authcode string Der Domain-Autorisierungscode

Fehler

Status Code Beschreibung
404 NOT_FOUND Die Domain wurde nicht gefunden
502 PROVIDER_ERROR Der Domain-Provider hat einen Fehler zurückgegeben

Beispiel

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

MCP

Diese Aktion ist auch über das get_authcode MCP-Tool verfügbar.

Bestellstatus abrufen

Rufe den aktuellen Status und die Details einer Bestellung anhand ihrer ID oder ihres Tokens ab. Verwende diesen Endpunkt, um den Bereitstellungsfortschritt nach einer Bestellung ueber die API oder MCP abzufragen.

Der :id-Parameter akzeptiert entweder die Bestell-ID (MongoDB ObjectId) oder das Bestell-Token (UUID).

Header

Header Erforderlich Wert
Authorization Ja Bearer DEIN_API_SCHLÜSSEL

Erforderlicher Scope

  • vps:provision für neue VPS-Bestellungen, vps:scale für VPS-Upgrades
  • webspace:provision für neue Webspace-Bestellungen, webspace:scale für Webspace-Upgrades
  • domains:provision für Domain-Bestellungen

Antwort

{
  "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"
  }
}

Antwortfelder

Feld Typ Beschreibung
id string Bestell-ID
token string Bestell-Token (UUID)
status string Aktueller Status (siehe unten)
type string Bestelltyp: VM oder DOMAIN
channel string Herkunftskanal: shop, api oder mcp
totalNet number Nettopreis (ohne MwSt.)
totalGross number Bruttopreis (inkl. MwSt.)
currency string Währungscode (EUR)
interval string Abrechnungsintervall (z.B. 1 month, 12 months)
provisionedResourceId string|null ID der bereitgestellten VPS oder Domain (nach Bereitstellung gesetzt)
provisionedAt string|null ISO 8601 Zeitstempel der abgeschlossenen Bereitstellung
createdAt string ISO 8601 Zeitstempel der Bestellerstellung
updatedAt string ISO 8601 Zeitstempel der letzten Aktualisierung

Bestellstatus

Status Beschreibung
PENDING Zahlung eingeleitet, warte auf Bestätigung
PROCESSING Zahlung bestätigt, Bereitstellung läuft
COMPLETED Vollständig bereitgestellt und aktiv
FAILED Zahlung fehlgeschlagen
CANCELED Bestellung wurde storniert
PROVISION_FAILED Zahlung erfolgreich, aber Bereitstellung fehlgeschlagen (Erstattung ausgestellt)
EXPIRED Bestellung vor Zahlung abgelaufen

Fehlerantworten

Status Code Beschreibung
404 NOT_FOUND Bestellung nicht gefunden oder gehört nicht zum authentifizierten Benutzer
403 INSUFFICIENT_SCOPE API-Schlüssel hat nicht den für diesen Bestelltyp erforderlichen Scope

Beispiel

# Bestellung nach ID abrufen
curl https://site.quest/api/v1/orders/507f1f77bcf86cd799439011 \
  -H "Authorization: Bearer sq_live_a94ecfca096d..."

# Bestellung nach Token abrufen
curl https://site.quest/api/v1/orders/a1b2c3d4-e5f6-7890-abcd-ef1234567890 \
  -H "Authorization: Bearer sq_live_a94ecfca096d..."

MCP

Diese Daten sind auch über das MCP-Tool get_order_status verfügbar.

Domain kündigen

Kündige ein Domain-Abonnement zum Ende der aktuellen Abrechnungsperiode. Die Domain bleibt bis zum Ablaufdatum aktiv und die automatische Verlängerung wird beim Registrar deaktiviert.

Erforderlicher Scope: domains:cancel

Pfad-Parameter

Parameter Typ Beschreibung
id string Die Domain-ID

Header

Header Erforderlich Wert
Authorization Ja Bearer DEIN_API_SCHLÜSSEL

Antwort

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

Antwortfelder

Feld Typ Beschreibung
id string Die Domain-ID
name string Der Domainname
cancelled boolean Immer true nach erfolgreicher Kündigung
expiresAt string ISO 8601 Datum, an dem das Domain-Abonnement abläuft

Fehlerantworten

Status Code Beschreibung
400 NO_SUBSCRIPTION Kein aktives Abonnement für diese Domain gefunden
400 CANCEL_FAILED Kündigung des Abonnements fehlgeschlagen
403 INSUFFICIENT_SCOPE API-Schlüssel hat nicht den erforderlichen domains:cancel-Scope
404 NOT_FOUND Domain nicht gefunden oder kein Eigentümerzugriff

Beispiel

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

Reaktivierung

Um eine gekündigte Domain vor dem Ablaufdatum zu reaktivieren, verwende den Domain reaktivieren Endpunkt.

MCP

Diese Aktion ist auch über das cancel_domain MCP-Tool verfügbar.

Domain reaktivieren

Reaktiviere ein gekündigtes Domain-Abonnement vor dem Ablaufdatum. Dies erstellt ein neues wiederkehrendes Abonnement und hebt die Kündigung auf, sodass die Domain normal weiter verlängert wird.

Erforderlicher Scope: domains:cancel

Pfad-Parameter

Parameter Typ Beschreibung
id string Die Domain-ID

Header

Header Erforderlich Wert
Authorization Ja Bearer DEIN_API_SCHLÜSSEL

Antwort

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

Antwortfelder

Feld Typ Beschreibung
id string Die Domain-ID
name string Der Domainname
reactivated boolean Immer true nach erfolgreicher Reaktivierung

Fehlerantworten

Status Code Beschreibung
400 NOT_CANCELLED Kein gekündigtes Abonnement für diese Domain gefunden
400 UNCANCEL_FAILED Reaktivierung des Abonnements fehlgeschlagen
403 INSUFFICIENT_SCOPE API-Schlüssel hat nicht den erforderlichen domains:cancel-Scope
404 NOT_FOUND Domain nicht gefunden oder kein Eigentümerzugriff

Beispiel

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

MCP

Diese Aktion ist auch über das uncancel_domain MCP-Tool verfügbar.