Broadcasts

List broadcasts

List broadcasts on the connected account, newest first. Cursor-paginated. status is draft, queued, sending or sent.

GEThttps://api.sndr.sh/api/cranl/v1/broadcasts
List broadcasts
curl 'https://api.sndr.sh/api/cranl/v1/broadcasts' \
  -H 'Authorization: Bearer sndr_your_access_token'
200OK
{
  "data": [
    {
      "id":               "bca_9b3e6d12-a40",
      "organization_id":  "org_8d41c7a2-3f6",
      "name":             "June newsletter",
      "group_id":         "grp_4d8a0c5e-1f7",
      "from_email":       "hello@acme.com",
      "subject":          "June product update",
      "html":             "<h1>June update</h1><p>Here is what is new.</p>",
      "status":           "sent",
      "total_recipients": 4200,
      "sent_count":       4188,
      "failed_count":     12,
      "created_at":       "2026-05-28T14:00:00Z",
      "started_at":       "2026-06-01T09:00:00Z",
      "completed_at":     "2026-06-01T09:42:10Z"
    }
  ],
  "has_more": false,
  "count":    1,
  "limit":    50
}

Authorization

Authorizationstringheaderrequired

Bearer followed by an access token. Needs the read scope.

Query parameters

limitinteger

Page size. Default 50, max 200.

cursorstring

The next_cursor value from the previous page. Omit for the first page.

Errors

401unauthenticatedMissing or invalid Bearer token.
401token_expiredAccess token expired — exchange the refresh token for a new pair.
401token_revokedToken was explicitly revoked.
403insufficient_scopeToken is missing the read scope.
422validation_failedlimit is above 200, or cursor is not a value returned as next_cursor.