メールアドレスを指定してバウンスの履歴を取得する。
同一のメールアドレスのバウンス履歴の内、最新の1000件分までを取得可能。
バウンス履歴は通常過去7日分保存される。
ジョブは非同期で実行され、レスポンスに含まれるジョブIDで結果を取得することができる。
リクエスト
エンドポイント
/v2/bounces/[メールアドレス]
HTTPメソッド
GET
リクエストボディ
なし
レスポンス
ステータスコード
状態
|
コード
|
---|---|
成功 | 200 |
メールアドレスが不正 | 400 |
認証失敗 | 401 |
実行中の同種別ジョブが多すぎる | 403 |
存在しないエンドポイント | 404 |
許可されていないHTTPメソッド | 405 |
システムエラーが発生した | 500 |
システムが一時的にサービスを提供できない状態になっている | 503 |
システムのタイムアウト | 504 |
レスポンスボディ
要素名
|
型
|
要素数
|
説明
|
---|---|---|---|
code | 数値 | 1 | ステータスコード |
job_id | 数値 | 1 | ジョブID |