Get broadcast details

Get a broadcast header including live delivery progress.

Required permissions: BROADCAST

get

/tenants/{tenantUid}/stores/{storeUid}/broadcasts/{broadcastUid}

Authorizations

AuthorizationstringRequired

Access token recevied after user login with a deviceToken

Path parameters

tenantUidstringRequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+

storeUidstringRequired

Reference to a Store.

Pattern: ^[A-Za-z0-9-_]+

broadcastUidstringRequired

Reference to a Broadcast.

Pattern: ^[A-Za-z0-9-_]+

Responses

200

BroadcastResponse

application/json

A broadcast header.

broadcastUidstringRequiredPattern: ^[A-Za-z0-9-_]+

channelstring · enumRequired

The delivery channel of a broadcast. A broadcast is single-channel.

Possible values:

purposestring · enumRequired

The purpose of a broadcast. MARKETING is a marketing message; SERVICE is a service/transactional message. Consent is the responsibility of the party building the recipient list: MARKETING sends must only include recipients with the relevant marketing consent (see add recipients).

Possible values:

statusstring · enumRequired

Lifecycle state of a broadcast. DRAFT: editable, recipients can be edited. LAUNCHED: committed to send — sent immediately when sendAt is null or in the past, or held until a future sendAt. SENDING: in progress. COMPLETED: all recipients processed. CANCELLED: stopped before/while sending. FAILED: aborted with an error.

Possible values:

titlestringRequired

Operator-facing label.

descriptionstringRequired

Operator-facing note. Empty string if not set.

bodystringRequired

The message content. Plain text for SMS, HTML for EMAIL.

subjectstringRequired

Email subject. Empty string for SMS.

senderstringRequired

Sender name/address. Empty string if resolved from configuration at send time.

storeUidstringRequired

Store the broadcast is sent in the context of — the SMS bill payer and/or sender.

Pattern: ^[A-Za-z0-9-_]+

sendAtstring · date-time · nullableRequired

Scheduled send time. Null means send immediately on launch.

startedAtstring · date-time · nullableRequired

When sending started. Null until the broadcast starts sending.

finishedAtstring · date-time · nullableRequired

When sending finished. Null until the broadcast completes.

createdAtstring · date-timeRequired

createdBystringRequired

lastModifiedAtstring · date-timeRequired

lastModifiedBystringRequired

get/tenants/{tenantUid}/stores/{storeUid}/broadcasts/{broadcastUid}

GET /v2/tenants/{tenantUid}/stores/{storeUid}/broadcasts/{broadcastUid} HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

BroadcastResponse

{
  "broadcastUid": "text",
  "channel": "SMS",
  "purpose": "MARKETING",
  "status": "DRAFT",
  "title": "text",
  "description": "text",
  "body": "text",
  "subject": "text",
  "sender": "text",
  "storeUid": "text",
  "sendAt": "2026-01-01T00:00:00.000Z",
  "startedAt": "2026-01-01T00:00:00.000Z",
  "finishedAt": "2026-01-01T00:00:00.000Z",
  "progress": {
    "totalCount": 1,
    "queuedCount": 1,
    "dispatchedCount": 1,
    "deliveredCount": 1,
    "failedCount": 1
  },
  "createdAt": "2026-01-01T00:00:00.000Z",
  "createdBy": "text",
  "lastModifiedAt": "2026-01-01T00:00:00.000Z",
  "lastModifiedBy": "text"
}