---
title: "List runs"
method: GET
path: "/v2/apps/runs"
tags: ["runs"]
---

# List runs

`GET /v2/apps/runs`

Return a list of runs. Use query parameters to filter results.

## Query parameters

- `app_id` string
- `app_name` string
- `deployment_id` string
- `username` string
- `run_id` string
- `status` string[]
- `output_workspaces` string[]
- `from_timestamp` integer
- `to_timestamp` integer
- `limit` integer
- `offset` integer
- `sort_by` 'start_timestamp' | 'status'
- `order` 'ASCENDING' | 'DESCENDING'

## Headers

- `Authorization` string, required
- `IB-Context` string

## Response `200`

A list of all runs.

- RunsListRunsResponse200
  - `runs` Run[]
    - `id` string — Run ID of the run.
    - `status` 'CANCELLED' | 'COMPLETE' | 'FAILED' | 'PAUSED' | 'RUNNING' | 'STOPPED_AT_CHECKPOINT' — Status of the run. Possible values and meanings: - `CANCELLED` -- A user cancelled the run - `COMPLETE` -- The run successfully completed. A human review completed if it was required. Results are retrievable, but some fields may have failed and have the value `ERROR`. - `FAILED` -- The run failed to complete - `PAUSED` -- This status is reserved for future use - `RUNNING` -- The run is in progress and is not paused - `STOPPED_AT_CHECKPOINT` -- A validation error has paused the run for human review
    - `start_timestamp` integer — When the run started, in Unix time nanoseconds.
    - `finish_timestamp` integer, nullable — When the run finished, in Unix time nanoseconds. `null` if run is still in progress.
    - `msg` string, nullable — Message about the run.
    - `batch_id` integer, nullable — The batch ID used as input for this run.
    - `input_dir` string, nullable — The path of the input folder used for this run.
    - `app_id` string, nullable — The app ID of the app that was run.
    - `deployment_id` string, nullable — The deployment ID used for this run.
    - `tags` string[], nullable — List of string tags attached to this run.

---

[API](https://skmtc.net/instabase/apis/api-reference.md) · [All operations](https://skmtc.net/instabase/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/instabase/api-reference/revisions/3a4f46d48141/schema)