List an announcement's messages

Lists the individual email messages an announcement produced - one per recipient, with delivery status - as a paginated envelope.

GET/v2/accounts/{accountId}/announcements/{announcementId}/messages

Base URL https://api.sendstreak.com. All v2 endpoints require a bearer token - see Authentication.

Path parameters

accountIdstringrequired

The account the request is scoped to.

announcementIdstringrequired

Query parameters

startintegeroptional

Zero-based offset of the first item to return. Default: 0.

limitintegeroptional

Maximum number of items to return. Clamped to 100. Default: 25.

Response

A page of messages.

Errors

401

Missing or invalid token, or the token is not authorized for this account/user.

See Errors and rate limits for what error responses look like.

curl --location --request GET 'https://api.sendstreak.com/v2/accounts/YOUR_ACCOUNT_ID/announcements/YOUR_ANNOUNCEMENT_ID/messages' \
--header 'Authorization: Bearer YOUR_API_TOKEN'
const res = await fetch('https://api.sendstreak.com/v2/accounts/YOUR_ACCOUNT_ID/announcements/YOUR_ANNOUNCEMENT_ID/messages', {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${process.env.SENDSTREAK_TOKEN}`
  }
});
import os, requests

res = requests.get(
    'https://api.sendstreak.com/v2/accounts/YOUR_ACCOUNT_ID/announcements/YOUR_ANNOUNCEMENT_ID/messages',
    headers={'Authorization': f"Bearer {os.environ['SENDSTREAK_TOKEN']}"},
)

response200application/json
{
  "start": 0,
  "limit": 25,
  "items": [
    {
      "_id": "665f0a2b1c9d440012ab34cd",
      "rcpt": "[email protected]",
      "subject": "Welcome to Acme!",
      "status": "queued",
      "templateSlug": "sign-up-thank-you",
      "parentType": "automation",
      "createDate": "2026-07-07T09:30:00.000Z",
      "rcptName": "Vera Nagy",
      "fromName": "Acme Team",
      "fromEmail": "[email protected]",
      "statusDetails": "Recipient has hard bounced",
      "content": "<h1>Welcome to Acme!</h1><p>Your account is ready.</p>",
      "textContent": "Welcome to Acme! Your account is ready.",
      "sentFromEmail": "[email protected]",
      "sentFromName": "Acme Support",
      "sentViaMailServer": "6652ee3f5a0c220015bc34de",
      "attachments": [
        {
          "filename": "hello.txt"
        }
      ]
    }
  ]
}