Copy
curl --location --request GET 'https://app.audienceful.com/api/emails/reports' \
--header 'Content-Type: application/json' \
--header 'X-Api-Key: <token>'
Copy
{
"count": 50,
"next": "https://localhost:8000/api/emails/reports/?page=2",
"previous": null,
"results": [
{
"id": "YYjbCtcEZJgswoPnYxdvBH",
"draft": {
"id": "dKvQk6HNNtduqrX98gEYyY",
"title": "Save 25% on everything you need for the winter"
},
"completed_at": "2025-08-18T15:35:36.604443Z",
"subject": "Save 25% on everything you need for the winter",
"audiences": ["Engaged users"],
"identity": "[email protected]",
"stats": {
"delivered": 12450,
"opened": 6189,
"unsubscribed": 5,
"complained": 0,
"failed": 16,
"clicked": 980,
"clicked_urls": {
"https://audienceful.com": 980
}
}
}
]
}
Send Reports
List Send Reports
This endpoint gets the list of send reports.
GET
https://app.audienceful.com
/
api
/
emails
/
reports
Copy
curl --location --request GET 'https://app.audienceful.com/api/emails/reports' \
--header 'Content-Type: application/json' \
--header 'X-Api-Key: <token>'
Copy
{
"count": 50,
"next": "https://localhost:8000/api/emails/reports/?page=2",
"previous": null,
"results": [
{
"id": "YYjbCtcEZJgswoPnYxdvBH",
"draft": {
"id": "dKvQk6HNNtduqrX98gEYyY",
"title": "Save 25% on everything you need for the winter"
},
"completed_at": "2025-08-18T15:35:36.604443Z",
"subject": "Save 25% on everything you need for the winter",
"audiences": ["Engaged users"],
"identity": "[email protected]",
"stats": {
"delivered": 12450,
"opened": 6189,
"unsubscribed": 5,
"complained": 0,
"failed": 16,
"clicked": 980,
"clicked_urls": {
"https://audienceful.com": 980
}
}
}
]
}
An optional search parameter to find drafts that match the passed string. Ex:
“My draft title”
Response
The API URL of the next page of reports. Can be null if there are no more
pages.
The API URL of the previous page of reports. Can be null if on page 0.
The total number of reports in this dataset ignoring pagination.
The list of reports returned
Hide properties
Hide properties
The id of the report.
The subject of the report.
The identity the email was sent from
The datetime (in UTC) when the emails finished sending
A list of audiences that were sent to. If empty, the entire contact list was
used.
All stats for the send
Show properties
Show properties
The number of emails delivered
The number of unique emails opened
The number of emails clicked
A dictionary that shows the number of clicks for each link in your email
The number of emails that failed to send
The number of users that unsubscribed due to the send
The number of users that complained about spam
Copy
curl --location --request GET 'https://app.audienceful.com/api/emails/reports' \
--header 'Content-Type: application/json' \
--header 'X-Api-Key: <token>'
Copy
{
"count": 50,
"next": "https://localhost:8000/api/emails/reports/?page=2",
"previous": null,
"results": [
{
"id": "YYjbCtcEZJgswoPnYxdvBH",
"draft": {
"id": "dKvQk6HNNtduqrX98gEYyY",
"title": "Save 25% on everything you need for the winter"
},
"completed_at": "2025-08-18T15:35:36.604443Z",
"subject": "Save 25% on everything you need for the winter",
"audiences": ["Engaged users"],
"identity": "[email protected]",
"stats": {
"delivered": 12450,
"opened": 6189,
"unsubscribed": 5,
"complained": 0,
"failed": 16,
"clicked": 980,
"clicked_urls": {
"https://audienceful.com": 980
}
}
}
]
}
⌘I