---
title: "Get broadcast event by ID"
method: GET
path: "/broadcastEvents/{broadcastEventId}"
tags: ["broadcastEvents"]
---

# Get broadcast event by ID

`GET /broadcastEvents/{broadcastEventId}`

## Path parameters

- `broadcastEventId` string, required

## Query parameters

- `_populate` string
- `_select` string

## Response `200`

The broadcast event was retrieved successfully

- BroadcastEvent — A BroadcastEvent records a single unit of work within a Luma broadcast flow, a bulk outbound messaging campaign sent to many patients at once (for example a recall or announcement uploaded as a spreadsheet). Each event tracks either a review action taken on the flow or the processing of one row or patient, including its current step (message queued, sent, failed, or skipped), any error encountered, and links to the associated patient and appointment.
  - `_id` string — Luma's internal ID of an object.
  - `user` string — The ID of the root account user.
  - `deleted` 0 | 1 — Flag for logical deletion where 1 means deleted.
  - `createdBy` string — The ID of the user who created this object.
  - `updatedBy` string — The ID of the user who updated this object.
  - `createdAt` string, date-time — The date/time when this object was created.
  - `updatedAt` string, date-time — The date/time when this object was updated.
  - `broadcastFlow` string — Luma's internal ID of an object.
  - `patient` string — Luma's internal ID of an object.
  - `statuses` object[]
    - `step` 'RowProcess' | 'MessageProcess'
    - `status` 'in-progress' | 'success' | 'failure' | 'skipped'
    - `stepCreatedAt` string, date-time
    - `stepUpdatedAt` string, date-time
    - `patient` string — Luma's internal ID of an object.
    - `retryCount` integer
  - `row` integer
  - `rowRecord` object

## Other responses

- `401` — Not authenticated
- `403` — Not authorized
- `404` — Not found
- `500` — Internal server error

---

[API](https://skmtc.net/lumahealth/apis/rest-service.md) · [All operations](https://skmtc.net/lumahealth/apis/rest-service/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lumahealth/rest-service/revisions/d3c75c2a2f1d/schema)