Skip to contentSkip to navigationSkip to topbar
Rate this page:
On this page

Subuser Bounces


(warning)

This documentation is for the SendGrid Web API v2

To access all the latest features and upcoming developments, please see our v3 API.


Retrieve Bounces

retrieve-bounces page anchor
URI ParameterRequiredRequirementsDescription
taskYesMust be set to getTask to retrieve bounces
userYesSubuser must be under your accountSubuser to retrieve bounces of
dateNo0 or 1Optional argument to retrieve the timestamps, in ISO-8601 format, Pacific Timezone: YYYY-MM-DD HH:MM:SS
JSONXML

Call

POSThttps://api.sendgrid.com/api/user.bounces.json
POST Dataapi_user=your_sendgrid_username&api_key=your_sendgrid_password&user=subuser_username&task=get&date=1

Response


_14
[
_14
{
_14
"email": "emaieexampexample@example.com",
_14
"status": "5.1.1",
_14
"reason": "550 5.1.1 unknown or illegal user: emaieexampexample@example.com",
_14
"created": "2014-12-06 08:34:48"
_14
},
_14
{
_14
"email": "emaileexampexample@example.com",
_14
"status": "5.1.1",
_14
"reason": "550 5.1.1 The email account that you tried to reach does not exist. Please try double-checking the recipient's email address for typos or unnecessary spaces. Learn more at http:\/\/support.google.com\/mail\/bin\/answer.py?answer=6596 qy3si50924603pab.12 - gsmtp ",
_14
"created": "2014-12-06 08:36:34"
_14
}
_14
]



SendGrid suppresses messages to bounced addresses, but entries can be removed from the suppression list at any time if redelivery to a bounced address is desired. Take care that the address should be redelivered to.

URI ParameterRequiredRequirementsDescription
taskYesMust be set to deleteTask to remove address from bounce suppression list
userYesSubuser must be under your accountSubuser to retrieve bounces of
emailYesAddress exists on the listAddress to remove from the Bounce suppression list
JSONXML
POSThttps://api.sendgrid.com/api/user.bounces.json
POST Dataapi_user=your_sendgrid_username&api_key=your_sendgrid_password&user=subuser_username&task=delete&email=bounceexampexample@example.com

_10
{
_10
"message": "success"
_10
}


Rate this page: