Skip to main content
GET
List schedule runs
Returns the schedule’s recent fires, newest first. Every fire produces a run record, including skipped and failed ones, so the history is gap-free. Runs are retained for 90 days. Returns a paginated list of run records.

Path parameters

schedule_id
string
required
The schedule’s id (UUID).

Query parameters

page
integer
default:"1"
Page number (1-based).
size
integer
default:"10"
Items per page. Maximum: 1000.
sort
string
default:"-scheduled_for"
Sort order. Options: scheduled_for, -scheduled_for.

The run record

id
string
Unique id for this run (UUID).
schedule_id
string
The schedule that fired.
status
string
Outcome of the fire: created, skipped_overlap (previous session still active), skipped_quota (organization at quota), or error.
scheduled_for
string
The fire’s due time (UTC, RFC 3339).
session_id
string | null
The created session’s id when status is created, otherwise null.
error
string | null
Failure detail when status is error.
triggered_manually
boolean
Whether the fire came from Trigger rather than the cron cadence.
created_at
string
When the run record was written.

Examples

Response

Errors