---
title: "Get runs of an ingest"
method: GET
path: "/ingests/{id}/runs"
tags: ["Ingests"]
---

# Get runs of an ingest

`GET /ingests/{id}/runs`

Currently only available for rtsp-pull ingests: a run is recorded every time the ingest is started. Runs are ordered by start time (most recent first).

## Path parameters

- `id` string, required — Ingest ID

## Response `200`

List of ingest runs

- PaginatedIngestRunResult
  - `data` IngestRun[], required — List of ingest runs
    - `ingestId` string, required — Ingest ID
    - `start` string, required — Run start timestamp
    - `end` string — Run end timestamp
    - `config` IngestRunConfig, required — Run configuration
      - `ingest` object, required
        - `type` string, required — Ingest type used
        - `url` string — Ingest URL used
      - `restream` object[], required — Restream destinations used
        - `id` string, required — Restream ID
        - `url` string, required — Restream URL
      - `captions` object[], required — Caption configuration used
        - `channel` number, required — Caption channel number
        - `language` string, required — Caption language code
        - `label` string — Caption label
      - `tracks` object, required — Audio track configuration used
        - `audio` object[] — Audio track configuration
          - `pid` number — Audio track PID (mandatory for multi-audio)
          - `language` string, required — Audio track language code
          - `label` string, required — Audio track label
    - `startType` string, required — How the run was started
    - `startId` string, required — ID of the entity who did the start action
    - `stopType` string — How the run was stopped
    - `stopId` string — ID of entity who did the stop action
  - `pagination` object, required — Pagination info
    - `hasMore` boolean, required — Whether more results are available
    - `cursor` string, required — Cursor for the next page of results

## Changes

- **2026-09-08** `da2a96d5163e` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/dolby/apis/theolive-api/changes/ingests/:id/runs/get.md)

---

[API](https://skmtc.dev/dolby/apis/theolive-api.md) · [All operations](https://skmtc.dev/dolby/apis/theolive-api/llms.txt) · [OpenAPI document](https://skmtc.dev/dolby/apis/theolive-api/revisions/66f6acc9dc2a?raw)