SendStreak logo
menu

Get an announcement

Returns a single announcement with its template reference, audience settings, and current delivery status.

Endpoint

GET https://api.sendstreak.com/v2/accounts/{accountId}/announcements/{announcementId}

All v2 endpoints require a bearer token - see Authentication.

Path parameters

Parameter Type Description
accountId string The account the request is scoped to.
announcementId string  

Response

The announcement.

{
  "_id": "665f0a2b1c9d440012ab34cd",
  "name": "Example name",
  "templateId": "6650cc1d3e8a220013ef78ab",
  "topicId": "6651dd2e4f9b110014ab90cd",
  "includeUnsubscribed": false,
  "status": "queued",
  "createDate": "2026-07-07T09:30:00.000Z"
}

Errors

Status Description
401 Missing or invalid token, or the token is not authorized for this account/user.
404 The requested resource does not exist.

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

Curl example

curl --location --request GET 'https://api.sendstreak.com/v2/accounts/YOUR_ACCOUNT_ID/announcements/YOUR_ANNOUNCEMENT_ID' \
--header 'Authorization: Bearer YOUR_API_TOKEN'
Try SendStreak for Free now!