List Send Reports

Returns a cursor-paginated list of completed email sends (send reports).

GEThttps://api.audienceful.com/v2/reports
curl --location --request GET 'https://api.audienceful.com/v2/reports' \
--header 'Content-Type: application/json' \
--header 'X-Api-Key: <your-api-key>'
{
  "data": [
    {
      "id": "YYjbCtcEZJgswoPnYxdvBH",
      "draft": {
        "id": "dKvQk6HNNtduqrX98gEYyY",
        "title": "Save 25% on everything you need for the winter"
      },
      "completed_at": "2026-07-04T12:00:00Z",
      "subject": "Save 25% on everything you need for the winter",
      "audiences": ["Engaged users"],
      "identity": "hello@yourbrand.com",
      "stats": {
        "delivered": 12450,
        "opened": 6189,
        "unsubscribed": 5,
        "complained": 0,
        "failed": 16,
        "clicked": 980,
        "clicked_urls": {
          "https://audienceful.com": 980
        }
      }
    }
  ],
  "has_more": true,
  "next_cursor": "cD0yMDI2LTA3LTA0VDEyOjAwOjAwWg"
}

Requires the reports:read scope. Send Reports are completed email sends, most recent first.

Query parameters

searchstring
Filter send reports by matching against the draft title. Example: My newsletter
page_sizenumberdefault: 25
The number of send reports to return per page.
cursorstring
The pagination cursor from a previous response's next_cursor. See Pagination.

Response

dataarray
The page of send reports.
Properties
idstring
The id of the send report.
draftobject
The draft that was sent.
Properties
idstring
The id of the draft.
titlestring
The title of the draft.
completed_atstring
The datetime (UTC) when the emails finished sending.
subjectstring
The subject line of the send.
audiencesarray[string]
The audiences that were sent to. If empty, the entire contact list was used.
identitystring
The identity (from address) the email was sent from.
statsobject
Send statistics.
Properties
deliverednumber
The number of emails delivered.
openednumber
The number of unique opens.
unsubscribednumber
The number of contacts who unsubscribed as a result of the send.
complainednumber
The number of spam complaints.
failednumber
The number of emails that failed to send.
clickednumber
The number of clicks.
clicked_urlsobject
A map of each link in the email to its click count.
has_moreboolean
Whether more send reports exist after this page.
next_cursorstring or null
The cursor to pass as ?cursor= to fetch the next page.
Last updated: July 11, 2026