---
title: "Get run status"
method: GET
path: "/v2/apps/runs/{run_id}"
tags: ["runs"]
---

# Get run status

`GET /v2/apps/runs/{run_id}`

Get the status of a run.

## Path parameters

- `run_id` string, required

## Headers

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

## Response `200`

Successful response.

- 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)