送信元メールドメインを取得

GET /v1/email-sender-domains/{sender_domain_id} · 権限 email-sender-domains:read · すべてのプラン

送信元ドメインのステータス、最後の DNS チェックの結果、公開すべき DNS レコードを返します。ETag ヘッダーにはバージョンが含まれます。ドメインを削除する際は、これを If-Match として送信してください。

リクエスト

フィールド 型 必須 説明
sender_domain_id string はい 送信元ドメイン ID（sdom_…）。

リクエストボディはありません。

レスポンス

200 OK と、送信元ドメインを返します。ETag にはそのバージョンが設定されます。

フィールド 型 説明
id string 送信元ドメイン ID（sdom_…）。
domain string IDNA 2008 の A ラベル形式のドメイン。小文字で、末尾のドットはありません。
status string pending_dns（DNS レコードの反映待ち）、verified（送信可能）、degraded（レコードが 72 時間失敗しており、環境はプラットフォーム送信にフォールバックしています）、または disabled（プラットフォームによって無効化されています）。
active_selector string 署名に使用される DKIM セレクタ。akp1 または akp2。
dkim_status string or null 2 つの DKIM CNAME の最後のチェック結果（両方のうち悪い方）。ok、missing、wrong_target、lookup_failed のいずれか。最初のチェック前は null。
return_path_status string or null Return-Path CNAME の最後のチェック結果。コードは同じです。最初のチェック前は null。
dmarc_alignment string or null 最後のチェックにおける DMARC の結果。aligned、not_aligned、no_record、invalid_record、lookup_failed のいずれか。DMARC は必須ではありません。
last_checked_at string or null 最後にチェックした時刻。
failing_since string or null verified ドメインで最初に失敗したチェックの時刻。72 時間に達すると、ドメインは degraded になります。
degraded_since string or null ドメインが degraded になった時刻。
records array 公開する DNS レコード。type（CNAME または TXT）、name、value、required を含みます。2 つの DKIM CNAME と Return-Path CNAME は必須です。最後のチェックで _dmarc レコードが見つからなかった場合は、DMARC の推奨設定（v=DMARC1; p=none）が required: false で追加されます。
version integer ドメインのバージョン。ETag と同じ値です。チェックを含め、書き込みのたびに増加します。
created_at string 作成日時。
updated_at string 最後に変更された日時。 
{
  "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"
}

エラー

HTTP code 発生条件
404 not_found 送信元ドメインが存在しない、別の環境に属している、または ID の形式が不正です。
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/sdom_01k7r9m3q5t8v2w4x6y8z0a2b4 \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"

CLI: keenauth email-sender-domains get sdom_01k7r9m3q5t8v2w4x6y8z0a2b4