Skip to main content
GET
List Runs

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

checkfu-version
enum<string>
required
Available options:
2026-08-31

Query Parameters

limit
integer
Required range: x >= 1
page
string
Pattern: ^c1_[0-9a-z]+$
order
enum<string>
Available options:
asc,
desc
session_id
string
Pattern: ^sess_[0-9a-f]{32}$
principal_id
string
Pattern: ^prin_[0-9a-f]{32}$
agent_id
string
Pattern: ^agent_[0-9a-f]{32}$
status
enum<string>
Available options:
queued,
running,
requires_action,
completed,
failed,
canceled

Response

Success

data
object[]
required

A Run folded from a canonical Session journal; native Runs carry no public execution identity.

next_page
string | null
required