Skip to main content
GET
curl

Authorizations

Authorization
string
header
required

A key generated from Settings → Developers, sent as Authorization: Bearer dr_live_<12 hex chars>_<64 hex chars>. Keys carry explicit scopes — each endpoint states the one it requires. The full key is shown exactly once at generation time and cannot be retrieved again; only the keyId prefix is shown afterward. A revoked key fails auth on its very next request.

Query Parameters

q
string

Only broadcasts whose name or subject contains this text (1 to 100 characters). Matched as plain text, so % and _ are not wildcards. Must not contain a NUL character (%00); one is rejected with VALIDATION_ERROR.

Required string length: 1 - 100
status
enum<string>

Only broadcasts with this status. paused is not accepted, though a paused broadcast can appear in the list.

Available options:
draft,
scheduled,
sending,
sent,
partial,
failed
sentAfter
string<date-time>

Only broadcasts sent at or after this instant (RFC 3339, e.g. 2026-10-01T00:00:00Z).

sentBefore
string<date-time>

Only broadcasts sent before this instant (RFC 3339). Must not be earlier than sentAfter, and the range may not exceed 366 days.

limit
integer
default:20

Broadcasts per page.

Required range: 1 <= x <= 100
cursor
string

The nextCursor from the previous page.

Maximum string length: 512

Response

A page of broadcasts.

data
object[]
required

The broadcasts on this page.

nextCursor
string | null
required

Pass as cursor to get the next page. null on the last page.