Retrieve complaints

If you have questions about the API, please visit our API FAQ page.

A complaint (feedback-loop report) occurs when a recipient marks your email as spam.

Monitoring complaints is important for protecting your sender reputation and maintaining healthy email deliverability.

Retrieve complaint events

Send a GET request to:

https://webapi.inboxroad.com/api/v1/fbl

Authentication is required. See Authentication.

Example request

curl -X GET 'https://webapi.inboxroad.com/api/v1/fbl' \
  -H 'X-API-Key: <your_token>' \
  -H 'Content-Type: application/json'

Response fields

Each complaint record contains the following fields:

Field name	Description
uuid	Unique identifier of the record.
timelogged	Unix timestamp of when the event was logged.
header_list_unsubscribe	List-Unsubscribe header.
orig	Originator (from MAIL FROM:).
rcpt	Recipient (RCPT TO:) being reported.
header_subject	Subject header of the original email.
header_return_path	Original Return-Path.
header_from	Original From header.
extra_fields	Any custom headers configured for your account.

Query parameters

Parameter	Possible values	Description
last_id	UUID of the last record	Returns records strictly newer than this record’s timelogged. Useful for incremental polling.
order	asc, desc	Sort order. Default is desc (newest first).
page	Integer	1-based page number.
page_size	Integer	Number of items per page. Default is 100, maximum is 1000.

Example with query parameters

curl -X GET 'https://webapi.inboxroad.com/api/v1/fbl?last_id=ce95fca7-b028-4f5c-810c-8bddeda4cac6&order=asc' \
  -H 'X-API-Key: <your_token>' \
  -H 'Content-Type: application/json'

Pagination

Responses use the following pagination structure:

Field name	Description
count	Total number of records.
next	URL to the next page, or null.
previous	URL to the previous page, or null.
results	List of complaint records.