List Broadcasts

List all broadcasts for the organization with cursor-based pagination.

GET/broadcasts

Requires a full_access API key.

Query Parameters

limitnumber

Maximum number of results to return. Min 1, max 100.

afterstring

Cursor for forward pagination.

beforestring

Cursor for backward pagination.

Response Fields

objectstring

Always "list".

has_moreboolean

Whether there are more results available.

dataarray

Array of broadcast objects. Each item contains id, segment_id, status, created_at, scheduled_at, sent_at, and topic_id.

curl -X GET 'https://api.postflare.app/broadcasts' \
  -H 'Authorization: Bearer re_xxxxxxxxx'

const response = await fetch('https://api.postflare.app/broadcasts', {
  headers: {
    'Authorization': 'Bearer re_xxxxxxxxx',
  },
});

const data = await response.json();

Response

{
  "object": "list",
  "has_more": false,
  "data": [
    {
      "id": "d4e5f6a7-b8c9-0123-defa-234567890123",
      "segment_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "status": "draft",
      "created_at": "2026-01-01T00:00:00.000Z",
      "scheduled_at": null,
      "sent_at": null,
      "topic_id": null
    }
  ]
}