Eine E-Mail-Absender-Domain abrufen

GET /v1/email-sender-domains/{sender_domain_id} · Berechtigung email-sender-domains:read · alle Tarife

Gibt eine Absender-Domain zurück: ihren Status, die Ergebnisse der letzten DNS-Prüfung und die zu veröffentlichenden DNS-Einträge. Der Header ETag enthält die Version; senden Sie sie als If-Match, wenn Sie die Domain löschen.

Anfrage

Feld Typ Pflicht Beschreibung
sender_domain_id string ja ID der Absender-Domain (sdom_…).

Kein Anfragetext.

Antwort

200 OK mit der Absender-Domain und ETag mit deren Version.

Feld Typ Beschreibung
id string ID der Absender-Domain (sdom_…).
domain string Die Domain als IDNA-2008-A-Label, in Kleinbuchstaben, ohne abschließenden Punkt.
status string pending_dns (wartet auf die DNS-Einträge), verified (bereit zum Senden), degraded (die Einträge schlagen seit 72 Stunden fehl; die Umgebung greift auf den Plattformversand zurück) oder disabled (von der Plattform deaktiviert).
active_selector string Für die Signatur verwendeter DKIM-Selector: akp1 oder akp2.
dkim_status string or null Letzte Prüfung der beiden DKIM-CNAMEs (das schlechtere der beiden Ergebnisse): ok, missing, wrong_target oder lookup_failed; null vor der ersten Prüfung.
return_path_status string or null Letzte Prüfung des Return-Path-CNAME mit denselben Codes; null vor der ersten Prüfung.
dmarc_alignment string or null DMARC-Ergebnis der letzten Prüfung: aligned, not_aligned, no_record, invalid_record oder lookup_failed. DMARC ist nicht erforderlich.
last_checked_at string or null Zeitpunkt der letzten Prüfung.
failing_since string or null Erste fehlgeschlagene Prüfung einer verified-Domain; nach 72 Stunden wird die Domain degraded.
degraded_since string or null Zeitpunkt, zu dem die Domain degraded wurde.
records array Zu veröffentlichende DNS-Einträge: type (CNAME oder TXT), name, value und required. Die beiden DKIM-CNAMEs und der Return-Path-CNAME sind erforderlich; wenn die letzte Prüfung keinen _dmarc-Eintrag gefunden hat, wird ein DMARC-Vorschlag (v=DMARC1; p=none) mit required: false ergänzt.
version integer Version der Domain, identisch mit dem ETag; sie steigt bei jeder Schreiboperation, einschließlich Prüfungen.
created_at string Zeitpunkt der Erstellung.
updated_at string Zeitpunkt der letzten Änderung. 
{
  "id": "sdom_01k7r9m3q5t8v2w4x6y8z0a2b4",
  "domain": "mail.example.com",
  "status": "pending_dns",
  "active_selector": "akp1",
  "dkim_status": null,
  "return_path_status": null,
  "dmarc_alignment": null,
  "last_checked_at": null,
  "failing_since": null,
  "degraded_since": null,
  "records": [
    {
      "type": "CNAME",
      "name": "akp1._domainkey.mail.example.com",
      "value": "akp1.sdom_01k7r9m3q5t8v2w4x6y8z0a2b4.dkim.eu.keenauth.app",
      "required": true
    },
    {
      "type": "CNAME",
      "name": "akp2._domainkey.mail.example.com",
      "value": "akp2.sdom_01k7r9m3q5t8v2w4x6y8z0a2b4.dkim.eu.keenauth.app",
      "required": true
    },
    {
      "type": "CNAME",
      "name": "rp.mail.example.com",
      "value": "rp.eu.mail.keenauth.app",
      "required": true
    }
  ],
  "version": 1,
  "created_at": "2026-10-19T09:00:00Z",
  "updated_at": "2026-10-19T09:00:00Z"
}

Fehler

HTTP Code Wann
404 not_found Die Absender-Domain existiert nicht, gehört zu einer anderen Umgebung oder die ID ist fehlerhaft.
401 unauthenticated Der Berechtigungsnachweis fehlt, ist ungültig oder widerrufen.
403 insufficient_permissions Dem Berechtigungsnachweis fehlt die erforderliche Berechtigung.
429 rate_limited Das Ratenlimit wurde überschritten; wiederholen Sie die Anfrage nach der Wartezeit Retry-After.
503 service_unavailable Eine Abhängigkeit ist vorübergehend nicht verfügbar; wiederholen Sie die Anfrage nach der Wartezeit Retry-After.

Beispiel

curl https://api.eu.keenauth.com/v1/email-sender-domains/sdom_01k7r9m3q5t8v2w4x6y8z0a2b4 \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"

CLI: keenauth email-sender-domains get sdom_01k7r9m3q5t8v2w4x6y8z0a2b4