API-Dokumentation

Domain abrufen

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

Anfrage

GET /api/v1/domains/{id}

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