List runs for a workflow

curl --request GET \
  --url https://app.base44.com/api/apps/{app_id}/workflows/{workflow_id}/runs \
  --header 'api_key: <api-key>'

const options = {method: 'GET', headers: {api_key: '<api-key>'}};

fetch('https://app.base44.com/api/apps/{app_id}/workflows/{workflow_id}/runs', 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://app.base44.com/api/apps/{app_id}/workflows/{workflow_id}/runs",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "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://app.base44.com/api/apps/{app_id}/workflows/{workflow_id}/runs"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("api_key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://app.base44.com/api/apps/{app_id}/workflows/{workflow_id}/runs")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["api_key"] = '<api-key>'

response = http.request(request)
puts response.read_body

[
  {
    "run_id": "0195f2a1-4c3e-7b21-9f0d-2a5c8e1b4d77",
    "workflow_id": "68b1c0d4e7b91d003c45a1f2",
    "status": "completed",
    "workflow_name": "Email me new signups",
    "trigger_type": "scheduled",
    "started_at": "2026-08-25T09:12:44Z",
    "completed_at": "2026-08-25T09:12:46Z",
    "duration_ms": 1840,
    "steps_count": 3,
    "error_message": "The email step failed because the recipient address was missing.",
    "is_test_run": false,
    "credits_consumed": 0.5,
    "status_reason": ""
  }
]

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

Runs

List runs for a workflow

This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.

Lists one workflow’s runs, newest first.

Use status to keep only runs in one state, since to keep only runs after a moment in time, and limit with offset to page.

Manual runs started through Run a workflow now appear here with is_test_run set to true.

This endpoint is limited to 60 requests per minute.

The response includes fields beyond the ones documented here. Don’t rely on undocumented response fields, as they can change at any time.

This endpoint accepts a personal API key. Workspace API keys are not authorized for it and are rejected with a 403.

GET

api

apps

{app_id}

workflows

{workflow_id}

runs

List runs for a workflow

curl --request GET \
  --url https://app.base44.com/api/apps/{app_id}/workflows/{workflow_id}/runs \
  --header 'api_key: <api-key>'

const options = {method: 'GET', headers: {api_key: '<api-key>'}};

fetch('https://app.base44.com/api/apps/{app_id}/workflows/{workflow_id}/runs', 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://app.base44.com/api/apps/{app_id}/workflows/{workflow_id}/runs",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "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://app.base44.com/api/apps/{app_id}/workflows/{workflow_id}/runs"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("api_key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://app.base44.com/api/apps/{app_id}/workflows/{workflow_id}/runs")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["api_key"] = '<api-key>'

response = http.request(request)
puts response.read_body

[
  {
    "run_id": "0195f2a1-4c3e-7b21-9f0d-2a5c8e1b4d77",
    "workflow_id": "68b1c0d4e7b91d003c45a1f2",
    "status": "completed",
    "workflow_name": "Email me new signups",
    "trigger_type": "scheduled",
    "started_at": "2026-08-25T09:12:44Z",
    "completed_at": "2026-08-25T09:12:46Z",
    "duration_ms": 1840,
    "steps_count": 3,
    "error_message": "The email step failed because the recipient address was missing.",
    "is_test_run": false,
    "credits_consumed": 0.5,
    "status_reason": ""
  }
]

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

Authorizations

api_key

string

header

required

Personal API key.

Path Parameters

app_id

string

required

ID of the app whose workflows you want to work with.

workflow_id

string

required

ID of the workflow, as returned in id by List workflows.

Query Parameters

limit

integer

default:30

Most runs to return.

Required range: 1 <= x <= 200

offset

integer

default:0

How many runs to skip, for paging.

Required range: x >= 0

status

string | null

Keep only runs in this state, for example failed.

since

string | null

Keep only runs that started at or after this ISO 8601 datetime.

Response

The workflow's runs, newest first.

run_id

string

required

ID of the run.

Example:

"0195f2a1-4c3e-7b21-9f0d-2a5c8e1b4d77"

workflow_id

string

required

ID of the workflow that ran.

Example:

"68b1c0d4e7b91d003c45a1f2"

status

string

required

How the run is going: running, completed, failed, or cancelled.

Example:

"completed"

workflow_name

string

default:""

Name of that workflow at the time of the run.

Example:

"Email me new signups"

trigger_type

string

default:""

What started the run, for example scheduled or entity_created.

Example:

"scheduled"

started_at

string | null

When the run started, as an ISO 8601 timestamp.

Example:

"2026-08-25T09:12:44Z"

completed_at

string | null

When the run finished. null while it is still running.

Example:

"2026-08-25T09:12:46Z"

duration_ms

integer

default:0

How long the run took, in milliseconds. 0 while it is still running.

Example:

1840

steps_count

integer

default:0

Steps the run executed.

Example:

3

error_message

string | null

Why the run failed. null when it did not fail.

Example:

"The email step failed because the recipient address was missing."

is_test_run

boolean

default:false

true when the run was started by hand through Run a workflow now, rather than by its trigger.

Example:

false

credits_consumed

number

default:0

Credits the run used.

Example:

0.5

status_reason

string

default:""

Why the run failed or was cancelled. Empty on runs that finished successfully.

Example:

""

⌘I

App Management API (Beta)

Entities API (Beta)

Virality API (Beta)

Workflows API (Beta)

Analytics API (Beta)

Google Ads API (Beta)

Monitoring API

Audit Logs API

List runs for a workflow

Authorizations

Path Parameters

Query Parameters

Response