ドメインを一覧する
ワークスペース上のすべてのドメインを、受信・送信・トラッキング・ファイルの状態とともに返します。
実際の呼び出しを、ご自身のキーで自分のワークスペースに対して実行します。
GET /domains
ワークスペース上のすべてのドメインを、受信・送信・トラッキング・ファイルの状態とともに返します。
受信と送信は別物
どのドメインも、受信と送信を 2 つの独立した状態オブジェクトとして報告します。receiving.verified は、そのドメインの MX がメールをここに運び、所有権チャレンジが公開されていること、つまりドメインが配信を受け取れることを意味します。送信については何も述べていません。
sending は送信側の半分で、新たにチェックするのではなく、保存されている署名チェックの結果を読み取ります。sending.status は verified、pending、failed、no_identity、unknown のいずれかです。sending.canSend はそのドメインからの送信が今すぐ受け付けられるかどうかを示し、sending.checkedAt はその判定の日時、sending.error は直近の失敗内容、sending.note は状態を説明する一文です。1 日以上前の否定的な判定は拒否ではなく unknown として扱われるため、status が pending でも canSend が true になることがあります。
tracking は 3 つ目のオブジェクトで、メールそのものではなく、ドメインの任意のカスタムトラッキングドメインについてのものです。アプリまたは PATCH /domains/{id} で設定するまで、tracking.status は none です。各フィールドの説明はそのページにあります。
storage は同じフィールドを持つ 4 つ目のオブジェクトで、ドメインの任意のカスタムファイルドメイン、つまりそのドメインから送られたファイルのダウンロードリンクが使う名前についてのものです。設定方法も設定ページも同じで、設定するまで storage.status は none です。
例
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 が null なら、DNS はまだ一度も見られていません。「失敗した」ではなく「まだ見ていない」です。ドメインを追加して 30 秒後には、この 2 つはまったく違う意味を持ちます。