API リファレンス

メールの状態を取得

送信時に返された ID で最新の配信状態を取得します。

リクエスト

GET /api/v1/emails/{id}

送信元プロジェクトの API キーを使います。不明な ID や他プロジェクトの ID は 404 を返します。

Shell

curl https://sendery.co/api/v1/emails/35a6b227-1748-412e-8651-430492201670 \
  -H "Authorization: Bearer $SENDERY_API_KEY" \
  -H 'Accept: application/json'

レスポンス

項目	説明
`id`	メッセージ ID。
`status`	最新の配信状態。
`error_code`	失敗理由、または `null`。
`created_at`	受付日時（UTC）。
`submitted_at`	送信受付日時（UTC）。送信前は `null`。サンドボックスの結果でも設定されます。

宛先、テンプレート変数、メール本文は返しません。

200 · application/json

{
  "id": "35a6b227-1748-412e-8651-430492201670",
  "status": "delivered",
  "error_code": null,
  "created_at": "2026-09-27T06:00:00.000000Z",
  "submitted_at": "2026-09-27T06:00:01.000000Z"
}

定期的な確認

数秒以上の間隔を空け、ポーリングには制限時間を設けてください。送信と状態取得はプロジェクトのレート制限を共有します。submitted や delayed は後から変わる場合があります。配信後にバウンスや迷惑メール報告が届く場合もあります。