Skip to main content
GET
/
runs
/
{run_uid}
/
status
Get a run status by UUID
curl --request GET \
  --url https://api.edges.run/v1/runs/{run_uid}/status \
  --header 'X-API-Key: <api-key>'
{
  "id": 123,
  "uid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "status": "CREATED",
  "postponed_until": "2023-11-07T05:31:56Z",
  "started_at": "<string>",
  "finished_at": "<string>",
  "created_at": "<string>",
  "updated_at": "<string>"
}
uid is used for all the endpoints and Run manipulation.The id is an internal identifier returned to smooth and improve speed and accuracy if you have questions about your runs you will want to submit to the team.
Use this endpoint to poll for run status without fetching full run details. This is useful for lightweight status checks in your automation workflows.

Authorizations

​
X-API-Key
string
header
required

Path Parameters

​
run_uid
string<uuid>
required

Run UUID

Response

Returns the run status

Returns the run status

​
id
integer

Run ID

​
uid
string<uuid>

Run UUID

​
status
enum<string> | null

Run status

Available options:
CREATED,
INVALID,
QUEUED,
SCHEDULED,
BLOCKED,
STOPPED,
RUNNING,
FAILED,
PARTIAL_SUCCEEDED,
SUCCEEDED
​
postponed_until
string<date-time> | null

If the run is postponed, this field indicates when it will be retried.

​
started_at
string | null

Started at

​
finished_at
string | null

Finished at

​
created_at
string

Created at

​
updated_at
string | null

Updated at