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>'import requests
url = "https://api.edges.run/v1/flows/runs/{flow_run_uid}/status"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://api.edges.run/v1/flows/runs/{flow_run_uid}/status', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.edges.run/v1/flows/runs/{flow_run_uid}/status",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-API-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.edges.run/v1/flows/runs/{flow_run_uid}/status"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.edges.run/v1/flows/runs/{flow_run_uid}/status")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.edges.run/v1/flows/runs/{flow_run_uid}/status")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"id": 123,
"uid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"status": "CREATED",
"started_at": "<string>",
"finished_at": "<string>",
"created_at": "<string>",
"updated_at": "<string>"
}{
"error_label": "<string>",
"error_scope": "input",
"error_ref": "ERR-12345",
"message": "<string>",
"status_code": 123,
"params": {},
"data": {}
}{
"error_label": "<string>",
"error_scope": "input",
"error_ref": "ERR-12345",
"message": "<string>",
"status_code": 123,
"params": {},
"data": {}
}Flow Runs
Get Flow Run Status
Get a lightweight status check for a flow run
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>'import requests
url = "https://api.edges.run/v1/flows/runs/{flow_run_uid}/status"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://api.edges.run/v1/flows/runs/{flow_run_uid}/status', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.edges.run/v1/flows/runs/{flow_run_uid}/status",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-API-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.edges.run/v1/flows/runs/{flow_run_uid}/status"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.edges.run/v1/flows/runs/{flow_run_uid}/status")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.edges.run/v1/flows/runs/{flow_run_uid}/status")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"id": 123,
"uid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"status": "CREATED",
"started_at": "<string>",
"finished_at": "<string>",
"created_at": "<string>",
"updated_at": "<string>"
}{
"error_label": "<string>",
"error_scope": "input",
"error_ref": "ERR-12345",
"message": "<string>",
"status_code": 123,
"params": {},
"data": {}
}{
"error_label": "<string>",
"error_scope": "input",
"error_ref": "ERR-12345",
"message": "<string>",
"status_code": 123,
"params": {},
"data": {}
}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
Path Parameters
Flow Run UUID
Response
Returns the flow run
Returns the flow run
Flow Run ID
Flow Run UUID
Flow Run status
Available options:
CREATED, INVALID, QUEUED, SCHEDULED, BLOCKED, STOPPED, RUNNING, FAILED, PARTIAL_SUCCEEDED, SUCCEEDED Started at
Finished at
Created at
Updated at

