---
title: "Fetch the status of a flow or flow job"
method: POST
path: "/flows/status"
tags: ["Flow"]
---

# Fetch the status of a flow or flow job

`POST /flows/status`

## Request

- Base URL: `https://api.recordedfuture.com/fusion/v3`
- URL: `https://api.recordedfuture.com/fusion/v3/flows/status`
- Auth: one of:
  - API key in header `X-RFToken`
  - OAuth 2
    - Authorization code: `https://id.recordedfuture.com/authorize`
    - Token URL: `https://id.recordedfuture.com/token`

Fetch the status of a flow job. You can filter on the job_id or flow_id

## Request body

- FlowStatusRequest
  - `job_id` string: A flow job id.
  - `flow_id` string: A flow id.
  - `limit` integer: Maximum number of job statuses to include in response.

## Response `200`

Operation result

- object[]
  - `job_id` string, required: Job id
  - `owner` string, required: Owner ID (uhash) of the flow.
  - `flow_id` string, required: Flow id
  - `block_states` object[], required: The state of each block in the flow configuration.
  - `record_count` number, required: The number of records processed by the flow (so far if not completed).
  - `error_message` string: Error message string, shows the cause of flow failure.
  - `block` string: The block id from where the flow executed. Only present when the flow was started using the run endpoint with the block parameter set.
  - `started` string, date-string
  - `updated` string, date-string
  - `finished` string, date-string
  - `failed` string, date-string
  - `aborted` string, date-string
  - `created` string, date-string
  - `version` integer, required: Flow version, essentially counts the number of updates made to the flow configuration.
  - `retries` integer, required: The number of times the flow has been retried after failing.

---

[API](https://skmtc.dev/recordedfuture/apis/fusion-api.md) - [All operations](https://skmtc.dev/recordedfuture/apis/fusion-api/llms.txt) - [OpenAPI document](https://skmtc.dev/recordedfuture/apis/fusion-api/revisions/15e440739cf0?raw)