Emaill addresses of recipients who marked your messages as a spam (for ESPs that support FBL).
Import list of complaints
Import CSV file containing a list of addresses to add to the complaint list.The CSV file must be 25MB or under and must contain the following column headers: address, created_at
Request Body schema: multipart/form-datarequired
A 202 response
A 400 response
A 500 response
- curl
- Go
- Node.js
- PHP
- Java
- Python
- C#
- Ruby
- 202
- 400
- 500
{- "message": "file uploaded successfully"
}View a single complaint record
Fetch a single complaint records to check if a given address is present in the list of complaints.
- curl
- Go
- Node.js
- PHP
- Java
- Python
- C#
- Ruby
- 200
- 404
{- "address": "alice@example.com",
- "created_at": "Mon, 06 May 2024 18:11:58 UTC"
}Clear a single complaint event
The delivery to the deleted email address resumes until there is another complaint.
- curl
- Go
- Node.js
- PHP
- Java
- Python
- C#
- Ruby
- 200
- 404
{- "message": "Complaint addresses for this domain have been removed",
- "address": "foo@bar.com"
}View all complaints
Paginate a list of complaints for the domain.
query Parameters
A 200 response
Response Schema: application/json
required | Array of objects |
required | object |
A 400 response
- curl
- Go
- Node.js
- PHP
- Java
- Python
- C#
- Ruby
- 200
- 400
{- "items": [
- {
- "address": "alice@example.com",
- "created_at": "Mon, 06 May 2024 18:11:58 UTC"
}
], - "paging": {
- "first": "<first page url>",
- "next": "<next page url>",
- "last": "<last page url>",
- "previous": "<previous page url>"
}
}Insert complaint records to the complaints list
Request body is expected to be a valid JSON encoded sting containing up to 1000 complaint records or a single complaint record as application/form-data
header Parameters
Request Body schema: required
- Payload
- curl
- Go
- Node.js
- PHP
- Java
- Python
- C#
- Ruby
- 200
- 400
{- "message": "2 complaint addresses have been added to the complaints table"
}Delete entire complaints list
Clears all email addresses with complaints from the domain. Delivery to the deleted email addresses will longer be suppressed.
- curl
- Go
- Node.js
- PHP
- Java
- Python
- C#
- Ruby
- 200
- 400
{- "message": "Complaint addresses for this domain have been removed"
}