List Runs
List runs across your account. Supports filtering by status, by the agent they reference, and by creation time.
get/v1/agents/runs
Query parameters
status'PENDING' | 'RUNNING' | 'COMPLETED' | 'FAILED' | 'STOPPED' | 'TIMED_OUT'
Current status of the run.
- PENDING - agent will run soon
- RUNNING - agent is currently running
- COMPLETED - agent has finished running
- FAILED - agent has failed the run
- STOPPED - run was stopped by the user
- TIMED_OUT - run exceeded maximum time
agentIdstring
Only return runs that reference this agent ID.
startAtstring date-time
Only return runs created on or after this timestamp (inclusive). ISO 8601 / RFC 3339, e.g. 2026-01-19T00:00:00Z.
endAtstring date-time
Only return runs created on or before this timestamp (inclusive). ISO 8601 / RFC 3339, e.g. 2026-01-20T00:00:00Z.
limitinteger
Maximum number of results to return.
cursorstring
Pagination cursor. Pass the nextCursor from the previous response to fetch the next page. Omit to start from the first page.
Response
The page of matching agent runs.