Skip to main content
GET
List Sessions

Authorizations

​
Authorization
string
header
required

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

Query Parameters

​
range
enum<string>
default:30d

Time window filtered on last_activity_at: last 24 hours (24h), 7 days (7d), 30 days (30d), or all time (all).

Available options:
24h,
7d,
30d,
all
Example:

"30d"

​
status
string | null

Filter by effective status: 'running', 'completed', 'failed', or 'abandoned'. 'abandoned' is computed at read time: stored status 'running' with last_activity_at older than SESSION_ABANDON_AFTER_SECONDS (default 30 min). Any other value matches nothing and returns an empty list.

Example:

"completed"

​
limit
integer
default:50

Page size (max 500).

Required range: 1 <= x <= 500
​
offset
integer
default:0

Rows to skip for pagination.

Required range: x >= 0
​
order_by
string
default:last_activity_at

Column to sort by: last_activity_at, started_at, ended_at, cost_usd, tokens_in, or tokens_out. Unknown values silently fall back to last_activity_at.

Example:

"cost_usd"

​
descending
boolean
default:true

Sort descending (newest/largest first).

Response

Successful Response