Skip to main content
GET
/
api
/
emails
/
reports
curl --location --request GET 'https://app.audienceful.com/api/emails/reports' \
--header 'Content-Type: application/json' \
--header 'X-Api-Key: <token>'

{
  "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
        }
      }
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://developer.audienceful.com/llms.txt

Use this file to discover all available pages before exploring further.

​
search
string
An optional search parameter to find drafts that match the passed string. Ex: “My draft title”

​
Response

​
next
string or null
The API URL of the next page of reports. Can be null if there are no more pages.
​
previous
string or null
The API URL of the previous page of reports. Can be null if on page 0.
​
count
number
The total number of reports in this dataset ignoring pagination.
​
results
array
The list of reports returned
curl --location --request GET 'https://app.audienceful.com/api/emails/reports' \
--header 'Content-Type: application/json' \
--header 'X-Api-Key: <token>'

{
  "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
        }
      }
    }
  ]
}