Skip to main content
GET
List runs

Authorizations

Authorization
string
header
required

A bearer token from Login, sent as Authorization: Bearer <token>. Valid for 60 minutes; it acts as the person named at login, within their organisation, and never approves. Rotating or disabling the organisation's API credential ends every token made with it on its next call. See Authentication.

Query Parameters

automation_id
string

Only the runs of this automation. A public id (a ULID).

Pattern: ^[0-9A-HJKMNP-TV-Z]{26}$
status
enum<string>

Only runs in this status, such as failed.

Available options:
queued,
running,
waiting_approval,
succeeded,
failed,
refused,
cancelled,
expired
page
integer
default:1

The page to read, from 1.

Required range: x >= 1
per_page
integer
default:25

Runs a page, 1 to 100 (25 unless you say).

Required range: 1 <= x <= 100

Response

A page of runs without steps.

success
boolean
required
contract_version
integer
required

The version of the API this answer follows. It changes only for a breaking change.

Required range: x >= 1
data
object
required