List Session Turns

GET/v1/agents/sessions/{session_id}/turns

Read Turns with cursor pagination. A Turn groups one input and the work it triggered, including its status. Read one Turn with GET /v1/agents/sessions/{session_id}/turns/{turn_id}.

Path parameters

stringsession_idrequired

Session ID (ses_ prefix).

Query parameters

Optional<integer>limit

Page size from 1 to 100. Values outside the range return 400.

Default: 20

Optional<string>after

Cursor. Pass last_id from the previous page.

Optional<string>order

asc or desc by creation time.

Default: desc

curl -X GET "https://api.sandbase.ai/v1/agents/sessions/ses_5b0e7c3a-91d2-5f4e-8a6b-2c9d4e1f7a83/turns?order=asc&limit=50" \
  -H "Authorization: Bearer $SANDBASE_API_KEY"