---
title: "Get broadcast history"
method: GET
path: "/projects/{id}/history"
tags: ["Projects"]
---

# Get broadcast history

`GET /projects/{id}/history`

## Request

- Base URL: `https://api.livereacting.com/v1/external`
- URL: `https://api.livereacting.com/v1/external/projects/{id}/history`
- Auth: HTTP bearer

Returns a paginated list of past broadcasts for a project.
Only includes completed (COMPLETED or ERROR status) broadcasts.
Results are sorted by date descending (most recent first).

## Path parameters

- `id` string, required

## Query parameters

- `limit` integer
- `offset` integer

## Response `200`

Broadcast history

- object
  - `history` BroadcastHistoryItem[]
    - `liveId` string: Unique live stream identifier
    - `date` string, date-time, nullable: When the broadcast started
    - `endedAt` string, date-time, nullable: When the broadcast ended
    - `duration` integer, nullable: Total duration in seconds
    - `peakViewers` integer, nullable: Peak viewers during the broadcast
    - `status` 'COMPLETED' | 'ERROR': Final status of the broadcast
    - `destinations` HistoryDestination[]
      - `provider` 'youtube' | 'facebook' | 'twitch' | 'instagram' | 'linkedin' | 'rtmp' | 'unknown'
      - `name` string, nullable
      - `viewingUrl` string, nullable: URL to the recording/VOD if available
      - `peakViewers` integer, nullable
      - `error` 'AUTH_ERROR' | 'PLATFORM_RATE_LIMITED' | 'CONNECTION_ERROR' | 'STREAM_ERROR' | 'UNKNOWN_ERROR' | 'null', nullable
  - `total` integer: Total number of broadcasts
  - `limit` integer: Maximum results per page
  - `offset` integer: Current offset

## Other responses

- `401`: Authentication failed
- `404`: Project not found
- `429`: Rate limit exceeded

---

[API](https://skmtc.dev/livereacting/apis/livereacting-api.md) · [All operations](https://skmtc.dev/livereacting/apis/livereacting-api/llms.txt) · [OpenAPI document](https://skmtc.dev/livereacting/apis/livereacting-api/revisions/17a9f1677fbf?raw)