Spam Reports

Retrieve and delete entries in the Spam Reports list.

get

URI Parameter	Required	Requirements	Description
date	No	Must be set to 1	Retrieve the timestamp of the spam report 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 spam reports (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 spam reports.
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 spam reports.
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.

Call

GET	`https://api.sendgrid.com/api/spamreports.get.json`
GET Data	`api_user=your_sendgrid_username&api_key=your_sendgrid_password&date=1`

Response

[
  {
    "ip": "174.36.80.219",
    "email": "example@aol.com",
    "created": "2009-12-06 15:45:08"
  },
  {
    "ip": "74.63.202.105",
    "email": "example@example.com",
    "created": "2009-12-08 07:43:01"
  }
]

Call

GET	`https://api.sendgrid.com/api/spamreports.get.xml`
GET Data	`api_user=your_sendgrid_username&api_key=your_sendgrid_password&date=1`

Response

<spamreports>
   <spamreport>
      <ip>174.36.80.219</ip>
      <email>example@aol.com</email>
      <created>2009-12-06 15:45:08</created>
   </spamreport>
   <spamreport>
      <ip>74.63.202.105</ip>
      <email>example@example.com</email>
      <created>2009-12-08 07:43:01</created>
   </spamreport>
</spamreports>

count

Retrieve the count of Spam Reports.

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 spam reports.
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 spam reports.

Call

GET	`https://api.sendgrid.com/api/spamreports.count.json`
GET Data	`api_user=your_sendgrid_username&api_key=your_sendgrid_password`

Response

{
  "count": 2
}

Call

GET	`https://api.sendgrid.com/api/spamreports.count.xml`
GET Data	`api_user=your_sendgrid_username&api_key=your_sendgrid_password`

Response

<result>
   <count>2</count>
   <result> </result>
</result>

delete

Delete an address from the Spam Reports list.

URI Parameter	Required	Requirements	Description
start_date	No	Date must be in YYYY-mm-dd format and be before the end_date parameter.	Optional date to start deleting from.
end_date	No	Date must be in YYYY-mm-dd format and be after the start_date parameter.	Optional date to end deleting from.
email	No	Must be a valid user account email	Email spam reports address to remove.
delete_all	No	value=1	This will delete the bounce list and will not be retrievable.

Call

POST	`https://api.sendgrid.com/api/spamreports.delete.json`
POST Data	`api_user=your_sendgrid_username&api_key=your_sendgrid_password&email=emailToDelete@domain.com`

Response

{
  "message": "success"
}

Call

POST	`https://api.sendgrid.com/api/spamreports.delete.xml`
POST Data	`api_user=your_sendgrid_username&api_key=your_sendgrid_password&email=emailToDelete@domain.com`

Response

<result>
   <message>success</message>
</result>

This documentation is for the SendGrid Web API v2

Thank you for your feedback!

Thanks for your feedback!