---
title: "Get Run"
method: GET
path: "/v1/runs/{flowRunId}"
tags: ["Runs"]
---

# Get Run

`GET /v1/runs/{flowRunId}`

Returns the latest status of a Run and output when complete.

## Path parameters

- `flowRunId` string, required

## Response `200`

A Run

- GetRunResponse
  - `flowRunId` string, required — The Sohar ID for the Run.
  - `status` 'CREATED' | 'IN_PROGRESS' | 'PENDING' | 'COMPLETE' | 'ERROR', required — Current status of the Run.
  - `output` object, nullable, required — The Run output when status is `COMPLETE`. The schema of this object is defined in the Flow template.
  - `errors` FlowRunResponseError[] — An optional array of error objects returned when status is `ERROR`.
    - `status` number, required — The status code for the error.
    - `param` string, nullable, required — The parameter that cause the error.
    - `error` string, required — The error message.
    - `state` string, required — The Flow state where the error occurred.

## Other responses

- `403` — Unauthorized
- `404` — Not found
- `413` — Context size limit exceeded
- `500` — Internal error

---

[API](https://skmtc.dev/soharhealth/apis/sohar-api.md) · [All operations](https://skmtc.dev/soharhealth/apis/sohar-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/soharhealth/sohar-api/revisions/2cb5fa45c18c/schema)