---
title: "GET /v1/flow-runs/{id}"
method: GET
path: "/v1/flow-runs/{id}"
tags: ["flow-runs"]
---

# GET /v1/flow-runs/{id}

`GET /v1/flow-runs/{id}`

Get Flow Run

## Path parameters

- `id` string, required

## Response `200`

Default Response

- object
  - `id` string, required
  - `created` string, required
  - `updated` string, required
  - `projectId` string, required
  - `flowId` string, required
  - `tags` string[]
  - `flowVersionId` string, required
  - `flowDisplayName` string, required
  - `logsFileId` string, nullable
  - `tasks` number
  - `status` union, required
    - 'FAILED'
    - 'QUOTA_EXCEEDED'
    - 'INTERNAL_ERROR'
    - 'PAUSED'
    - 'RUNNING'
    - 'STOPPED'
    - 'SUCCEEDED'
    - 'MEMORY_LIMIT_EXCEEDED'
    - 'TIMEOUT'
  - `duration` number
  - `startTime` string, required
  - `finishTime` string
  - `environment` union, required
    - 'PRODUCTION'
    - 'TESTING'
  - `steps` object, required

## Changes

- **2025-01-09** `b6ee827ed6ef` — 1 info
  - added `subschema #8` to the `status` response property `anyOf` list for the response status `200`
- **2024-09-09** `b04deb48df4b` — 1 info
  - added the optional property `logsFileId` to the response with the `200` status
- **2024-08-14** `ed47604969c3` — 1 breaking
  - the response property `finishTime` became optional for the status `200`
- **2024-06-11** `a1d1c2fbc615` — 1 info
  - added the optional property `duration` to the response with the `200` status
- **2024-03-04** `7d2c62096ae1` — 1 info
  - endpoint added

[Full history](https://skmtc.dev/activeboxes/apis/activeboxes-documentation/changes/v1/flow-runs/:id/get.md)

---

[API](https://skmtc.dev/activeboxes/apis/activeboxes-documentation.md) · [All operations](https://skmtc.dev/activeboxes/apis/activeboxes-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/activeboxes/activeboxes-documentation/revisions/12c564515962/schema)