---
title: "List Orchestration Runs"
method: GET
path: "/orchestration_runs"
tags: ["Orchestration Runs"]
---

# List Orchestration Runs

`GET /orchestration_runs`

List all Orchestration Runs in pages, sorted by due date in descending order (most recent first). Optionally filter by Orchestration ID.

## Query parameters

- `starting_after` string
- `limit` integer
- `orchestration_id` string

## Response `200`

- PagedOrchestrationRunDto
  - `has_more` boolean, required — Indicates whether there are more items to be fetched in the subsequent pages.
  - `next_cursor` string — The cursor to use in pagination. Use this value as `starting_after` to get the next page.
  - `data` OrchestrationRunDto[], required — List of Orchestration Runs
    - `id` string, required — The ID of the Orchestration Run.
    - `orchestration_id` string, required — The ID of the Orchestration this run belongs to.
    - `status` 'CANCELED' | 'COMPLETED' | 'FAILED' | 'NOT_STARTED' | 'RUNNING', required — The status of the run.
    - `due_at` string, date-time, required — The datetime when the run was due to start.
    - `started_at` string, date-time — The datetime when the run actually started.
    - `finished_at` string, date-time — The datetime when the run finished.

---

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