Skip to main content
GET
List runs

Authorizations

Authorization
string
header
required

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

Query Parameters

schedule_id
string | null

Filter to runs belonging to a specific schedule.

Example:

"sched_01HXYZ..."

account_id
string | null

Filter to runs for a specific linked account.

Example:

"acc_01HXYZ..."

status
enum<string> | null

Filter by run lifecycle status.

Available options:
running,
success,
failed,
incomplete,
null
page
number | null

The 1-based page number to fetch. Omit both page and page_size to fetch all runs at once.

Required range: x >= 1
page_size
number | null
default:25

The number of runs to return per page.

Required range: 1 <= x <= 100

Response

The runs were retrieved.

page
number
required

The current page number.

page_size
number
required

The number of runs per page.

total
number
required

The total number of runs matching the request.

data
object[]
required

The runs on this page.