This endpoint allows you to retrieve and delete entries in the Invalid Emails list.
Retrieve a list of invalid emails with addresses and response codes, optionally with dates.
URI Parameter |
Required |
Requirements |
Description |
date |
No |
Must be set to 1 |
Retrieve the timestamp of the invalid email records. It will return a date in a MySQL timestamp format - YYYY-MM-DD HH:MM:SS |
days |
No |
If specified, must be an integer greater than 0 |
Number of days in the past for which to retrieve invalid emails (includes today) |
start_date |
No |
Date must be in YYYY-MM-DD format and be earlier than the end_date parameter. |
The start of the date range for which to retrieve invalid emails. |
end_date |
No |
Date must be in YYYY-MM-DD format and be later than the start_date parameter. |
The end of the date range for which to retrieve invalid emails. |
limit |
No |
Some integer |
Optional field to limit the number of results returned. |
offset |
No |
Some integer |
Optional beginning point in the list to retrieve from. |
email |
No |
Email address eg testing@example.com |
Optional email addresses to search for. |
GET |
https://api.sendgrid.com/api/invalidemails.get.json |
GET Data |
api_user=apikey&api_key=your_sendgrid_api_key&date=1 |
[
{
"reason": "Known bad domain",
"created": "2011-06-06 16:11:57",
"email": "test@example.com"
},
{
"reason": "Invalid address",
"created": "2012-08-17 11:04:38",
"email": "brandon"
}
]
GET |
https://api.sendgrid.com/api/invalidemails.get.xml |
GET Data |
api_user=apikey&api_key=your_sendgrid_api_key&date=1 |
<invalidemails>
<invalidemail>
<reason>Known bad domain</reason>
<created>2011-06-06 16:11:57</created>
<email>test@example.com</email>
</invalidemail>
<invalidemail>
<reason>Invalid address</reason>
<created>2012-08-17 11:04:38</created>
<email>brandon</email>
</invalidemail>
</invalidemails>
Retrieve the count of invalid emails.
URI Parameter |
Required |
Requirements |
Description |
start_date |
No |
Date must be in YYYY-MM-DD format and be earlier than the end_date parameter. |
The start of the date range for which to retrieve invalid emails. |
end_date |
No |
Date must be in YYYY-MM-DD format and be later than the start_date parameter. |
The end of the date range for which to retrieve invalid emails. |
GET |
https://api.sendgrid.com/api/invalidemails.count.json |
GET Data |
api_user=apikey&api_key=your_sendgrid_api_key |
GET |
https://api.sendgrid.com/api/invalidemails.count.xml |
GET Data |
api_user=apikey&api_key=your_sendgrid_api_key |
<result>
<count>2</count>
<result> </result>
</result>
Delete an address from the Invalid Email list.
URI Parameter |
Required |
Requirements |
Description |
email |
Yes |
Must be a valid user account email |
Email Invalid Email address to remove |
POST |
https://api.sendgrid.com/api/invalidemails.delete.json |
POST Data |
api_user=apikey&api_key=your_sendgrid_api_key&email=emailToDelete@domain.com |
POST |
https://api.sendgrid.com/api/invalidemails.delete.xml |
POST Data |
api_user=apikey&api_key=your_sendgrid_api_key&email=emailToDelete@domain.com |
<result>
success
<result> </result>
</result>