Skip to main content
GET
/
flows
/
runs
/
{flow_run_uid}
/
status
Get flow run status by UUID
curl --request GET \
  --url https://api.edges.run/v1/flows/runs/{flow_run_uid}/status \
  --header 'X-API-Key: <api-key>'
{
  "id": 123,
  "uid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "started_at": "<string>",
  "finished_at": "<string>",
  "created_at": "<string>",
  "updated_at": "<string>"
}
A lightweight endpoint to check the current status of a flow run. This returns minimal information compared to the full Get Flow Run endpoint, making it ideal for quick status checks.
We recommend using callbacks instead of polling this endpoint. Callbacks are more efficient and reliable. Configure a callback URL when creating a flow run to receive results automatically.

Authorizations

​
X-API-Key
string
header
required

Path Parameters

​
flow_run_uid
string<uuid>
required

Flow Run UUID

Response

Returns the flow run

Returns the flow run

​
id
integer

Flow Run ID

​
uid
string<uuid>

Flow Run UUID

​
status
enum<string> | null

Flow Run status

Available options:
CREATED,
INVALID,
QUEUED,
SCHEDULED,
BLOCKED,
STOPPED,
RUNNING,
FAILED,
PARTIAL_SUCCEEDED,
SUCCEEDED
​
started_at
string | null

Started at

​
finished_at
string | null

Finished at

​
created_at
string

Created at

​
updated_at
string | null

Updated at