送信元メールドメインを一覧表示
GET /v1/email-sender-domains · 権限 email-sender-domains:read · すべてのプラン
環境の送信元メールドメインを、古いものから順に一覧表示します。環境には最大 10 件の送信元ドメインしかないため、一覧はページ分割されません。list_metadata.before と list_metadata.after は常に null です。送信元ドメインは production 環境にのみ存在し、それ以外の環境では一覧は空です。
リクエストパラメータやリクエストボディはありません。
レスポンス
200 OK と、環境のすべての送信元ドメインを返します。各項目は 送信元メールドメインを取得 で説明しているフィールドを持ちます。
{
"data": [
{
"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"
}
],
"list_metadata": {
"before": null,
"after": null
}
}
エラー
| HTTP | code | 発生条件 |
|---|---|---|
| 401 | unauthenticated |
認証情報が見つからない、無効、または取り消されています。 |
| 403 | insufficient_permissions |
認証情報に必要な権限がありません。 |
| 429 | rate_limited |
レート制限を超えました。Retry-After の期間を待ってから再試行してください。 |
| 503 | service_unavailable |
依存先が一時的に利用できません。Retry-After の期間を待ってから再試行してください。 |
例
curl https://api.eu.keenauth.com/v1/email-sender-domains \
-H "Authorization: Bearer $KEENAUTH_SECRET_KEY"
CLI: keenauth email-sender-domains list