Domains auflisten
Jede Domain des Workspace, mit ihrem Zustand für Empfang, Versand, Tracking und Dateien.
Führt den echten Aufruf gegen Ihren Workspace aus, mit Ihrem eigenen Schlüssel.
GET /domains
Jede Domain des Workspace, mit ihrem Zustand für Empfang, Versand, Tracking und Dateien.
Empfang und Versand sind getrennt
Jede Domain meldet Empfang und Versand als zwei unabhängige Zustandsobjekte. receiving.verified bedeutet, dass der MX der Domain ihre Mail hierher bringt und ihr Besitznachweis veröffentlicht ist, die Domain also Zustellungen annehmen kann. Über ausgehende Mail sagt es nichts aus.
sending ist die ausgehende Hälfte und stammt aus der gespeicherten Signaturprüfung der Domain, nicht aus einer frischen. sending.status ist eines von verified, pending, failed, no_identity oder unknown, sending.canSend sagt, ob ein Versand von der Domain gerade jetzt akzeptiert würde, sending.checkedAt datiert dieses Urteil, sending.error trägt den letzten Fehlschlag, und sending.note ist ein Satz, der den Zustand erklärt. Ein negatives Urteil, das älter als ein Tag ist, gilt als unbekannt und nicht als Ablehnung; canSend kann daher true sein, während status auf pending steht.
tracking ist ein drittes Objekt und betrifft die optionale eigene Tracking-Domain, nicht die Mail. tracking.status ist none, bis eine gesetzt wird, in der App oder mit PATCH /domains/{id}, dessen Seite jedes Feld beschreibt.
storage ist ein viertes Objekt mit denselben Feldern und betrifft die optionale eigene Dateien-Domain: den Namen, den die Download-Links für Dateien verwenden, die von dieser Domain versendet werden. Sie wird auf demselben Weg und auf derselben Seite gesetzt, und storage.status ist none, bis eine gesetzt wird.
Beispiel
Erfordert domains:read.
curl "$OE/domains" -H "$AUTH"{ "object": "list", "data": [ { "object": "domain", "id": "b3e1f0a4-6c2d-4e8a-9f17-2d5c8a0b4e6f", "domain": "acme.com", "receiving": { "verified": true, "verifiedAt": "2026-08-14T10:02:00.000Z", "catchAll": false, "lastCheckedAt": "2026-08-29T06:00:00.000Z", "error": null }, "sending": { "status": "verified", "canSend": true, "checkedAt": "2026-08-29T06:00:00.000Z", "error": null, "note": "Mail from this domain is signed and can be sent." }, "tracking": { "host": "links.acme.com", "status": "active", "active": true, "target": "oelinks3f9a1c7e2b8d4a60.edge.openemail.uk", "record": { "type": "CNAME", "name": "links.acme.com", "value": "oelinks3f9a1c7e2b8d4a60.edge.openemail.uk" }, "checkedAt": "2026-08-29T06:10:00.000Z", "verifiedAt": "2026-08-29T06:10:00.000Z", "error": null }, "storage": { "host": "files.acme.com", "status": "active", "active": true, "target": "oefiles81c40d6b2f7e9a35.edge.openemail.uk", "record": { "type": "CNAME", "name": "files.acme.com", "value": "oefiles81c40d6b2f7e9a35.edge.openemail.uk" }, "checkedAt": "2026-08-29T06:10:00.000Z", "verifiedAt": "2026-08-29T06:10:00.000Z", "error": null }, "createdAt": "2026-08-14T09:55:11.000Z" } ]}lastCheckedAt gleich null bedeutet, dass DNS noch nie angesehen wurde: „wir haben noch nicht nachgesehen“, nicht „es ist fehlgeschlagen“. Dreißig Sekunden nach dem Hinzufügen einer Domain lesen sich beide sehr unterschiedlich.