Get sessions
Get list of sessions with pagination and filtering. See Sessions.
Authorizations
API key authorization. Pass your API key in the Authorization header as a Bearer token. Both new (gsk_*) and legacy (gsk-) API keys are accepted, e.g. Authorization: Bearer gsk_... or Authorization: Bearer gsk-....
Query Parameters
Filter by session IDs
Filter by session custom IDs
Filter by product IDs
Filter by test IDs (include only). Use an empty string ("") to select sessions without a test
Omit sessions linked to the specified test IDs. Use an empty string ("") to omit sessions without a test
Filter by version IDs
Filter by monitor IDs (returns only sessions scored by the given monitors)
Filter by test case IDs
Filter by the session's isProduction flag. Prefer this over the legacy testIds/excludeTestIds empty-string trick.
Filter by session statuses. Multiple values combine as OR.
PENDING, COMPLETED, FAILED Filter by comment state. __any__ matches sessions with at least one comment, __none__ matches sessions with no comment, and any other value matches sessions with a comment carrying that label. All values combine as OR, so __none__ plus a label returns sessions that have no comment OR carry that label.
Sort instructions (field and direction pairs)
Maximum number of results
Number of results to skip
Filter sessions created at or after this timestamp (ISO 8601 format)
Filter sessions created at or before this timestamp (ISO 8601 format)
Response
Sessions retrieved successfully
"session_123"
"custom_session_123"
"ver_123"
"user_123"
"tc_123"
Structured context data. For plain text context, format is { value: "..." }
"GOAL_ACHIEVED"
Canonical storage URI of the full-call recording for a telephony-evaluation session. Null for non-telephony sessions or before the recording is processed. Resolve to a playable URL via GET /storage?uri=.
"s3://galtea-bucket/audio/org_123/session_abc-recording.mp3"
"External API responded with HTTP 422: Unprocessable Entity — {\"detail\":\"model not found\"}"
PENDING, COMPLETED, FAILED "PENDING"
True when the session represents real production traffic (no associated test case).
false