Manage your customers' bounce records.
URI Parameter
Required
Requirements
Description
user
Yes
Customer must be registered under your account
The customer we are retrieving bounces from
task
Yes
Must be set to get
This will allow you to retrieve the bounces for the specified customer
date
No
Must be set to 1
Retrieves the timestamps. It will return a date in a MySQL timestamp format - YYYY-MM-DD HH:MM:SS
method
Yes
Must be set to bounces
Allows you to access bounces functionality
JSON
XML
POST
https://api.sendgrid.com/apiv2/reseller.manage.json
POST Data
api_user=your_sendgrid_username&api_key=your_sendgrid_password&method=bounces&user=eexampexample@example.com&task=get&date=1
[
{
"email": "emaieexampexample@example.com",
"status": "5.1.1",
"reason": "host [127.0.0.1] said: 550 5.1.1 unknown or illegal user: emaieexampexample@example.com",
"created": "2009-06-01 19:41:39"
},
{
"email": "emaileexampexample@example.com",
"status": "5.1.1",
"reason": "host [127.0.0.1] said: 550 5.1.1 unknown or illegal user: emaileexampexample@example.com",
"created": "2009-06-01 19:41:39"
}
]
POST
https://api.sendgrid.com/apiv2/reseller.manage.xml
POST Data
api_user=your_sendgrid_username&api_key=your_sendgrid_password&method=bounces&user=eexampexample@example.com&task=get&date=1
<bounces>
<bounce>
<email>emaieexampexample@example.com</email>
<status>5.1.1</status>
<reason>host [127.0.0.1] said: 550 5.1.1 unknown or illegal user: emaieexampexample@example.com</reason>
<created>2009-06-10 12:40:30</created>
</bounce>
<bounce>
<email>emaileexampexample@example.com</email>
<status>5.1.1</status>
<reason>host [127.0.0.1] said: 550 5.1.1 unknown or illegal user: emaileexampexample@example.com</reason>
<created>2009-06-10 12:40:30</created>
</bounce>
</bounces>
Since SendGrid does not re-deliver to bounced addresses, users can remove bounces from their list at any time if redelivery to a bounced address is desired.
URI Parameter
Required
Requirements
Description
user
Yes
Subuser must be registered under your account
The subuser we are retrieving bounces from
task
Yes
Must be set to delete
This will allow you to delete the bounces for the specified user
email
Yes
Bounce email address you want to delete
You must specify the bounced email message to remove
method
Yes
Must be set to bounces
Allows you to access bounces functionality
JSON
XML
POST
https://api.sendgrid.com/apiv2/reseller.manage.json
POST Data
api_user=your_sendgrid_username&api_key=your_sendgrid_password&method=bounces&user=eexampexample@example.com&task=delete&email=bounceexampexample@example.com
POST
https://api.sendgrid.com/apiv2/reseller.manage.xml
POST Data
api_user=your_sendgrid_username&api_key=your_sendgrid_password&method=bounces&user=eexampexample@example.com&task=delete&email=bounceexampexample@example.com
<result>
<message>success</message>
</result>