Amazon SES Bounce Retrieval API
Bouncely REST API makes it easy for developers to add their own layer of awesomeness on top of our platform.
The API lets you retrieve information concerning your bounces and spam complaints. To use it you need an API key that refers to the email that you want to retrieve data from. You can find your API key in your account under email settings tab that refers to the desired email.
Get Bounces
GET http://api.bouncely.com/api/v1/{api_key}/{date}.{format}
Fetches a portion of bounces according to the specified input criteria. Bounces are sorted by bounce date in a descending order.
Bounce retrieval parameters:
- api_key – the key associated with your account that works as authentication mechanism.
-
date – returns bounces which bounced during the day specified.
- today
- yesterday
- YYYY-MM-DD
-
format – the response can be a JSON object or a XML structure. So, you should specify one of the following options according to your desire.
- json
- xml
The JSON response format is:
[
{
"subject":"Newsletter!",
"BouncedAt":"2011-05-12 11:27:23",
"Email":"test@test.com",
"Type":"HardBounce" or "SoftBounce" or "Spam",
"Message_id":"<0000012fe3f5f627-aa534c75-cca9-43f5-a42b-7a15bdaf2cbf-000000@email.amazonses.com>",
"Email_id":"12345" (unique email identifier)
},
{ ... },
... ]
