送信元メールドメインを一覧表示

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