List Archive Entries

Returns a cursor-paginated list of the broadcasts a workspace has published to its archive.

GEThttps://api.audienceful.com/v2/archive

curl --location --request GET 'https://api.audienceful.com/v2/archive' \
--header 'Content-Type: application/json' \
--header 'X-Api-Key: <your-api-key>'

{
  "data": [
    {
      "id": "YYjbCtcEZJgswoPnYxdvBH",
      "slug": "save-25-percent-this-winter",
      "title": "Save 25% on everything you need for the winter",
      "subject": "Save 25% on everything you need for the winter",
      "preheader": "Our biggest sale of the season is here.",
      "publication": {
        "id": "kR2xN9mDfLpQ",
        "name": "The Weekly"
      },
      "published_at": "2026-07-04T12:00:00Z",
      "public": true,
      "url": "https://archive.yourbrand.com/save-25-percent-this-winter"
    }
  ],
  "has_more": true,
  "next_cursor": "cD0yMDI2LTA3LTA0VDEyOjAwOjAwWg"
}

Requires the archive:read scope. Archive entries are the bulk broadcasts a workspace has published to its archive, most recent first. Each entry shares its id with the matching send report, so the two endpoints join naturally.

The archive never contains automation or transactional sends — only broadcasts. To fetch the rendered HTML of a single entry, retrieve it by id.

Query parameters

publicstringdefault: true

Which entries to return, based on their effective archive visibility. true returns only curated entries that are shown in the archive, false returns only the ones you've hidden, and all returns both.

page_sizenumberdefault: 25

The number of entries to return per page.

cursorstring

The pagination cursor from a previous response's next_cursor. See Pagination.

Response

dataarray

The page of archive entries.

Properties

idstring

The id of the entry. This is the same id the matching send report uses.

slugstring

The URL slug of the entry's hosted post.

titlestring

The title of the broadcast.

subjectstring

The subject line the broadcast was sent with.

preheaderstring

The preheader (preview text) of the broadcast.

publicationobject or null

The publication the entry belongs to, or null if it isn't assigned to one.

Properties

idstring

The id of the publication.

namestring

The name of the publication.

published_atstring

The datetime (UTC) when the entry was published to the archive.

publicboolean

Whether the entry is shown in the archive. This reflects the effective visibility: an entry is false if it was hidden individually or if its whole publication is hidden.

urlstring or null

The URL of the hosted post, or null when the workspace isn't serving hosted archive pages.

has_moreboolean

Whether more entries exist after this page.

next_cursorstring or null

The cursor to pass as ?cursor= to fetch the next page.