Get Trace Statistics by Session

Retrieve aggregated trace statistics grouped by session ID with pagination.

Provides insights into:

Total traces per session
First and last trace timestamps per session
Associated user and agent information

Filtering Options:

By user ID
By agent ID

Use Cases:

Monitor session-level activity
Track conversation flows
Identify high-activity sessions
Analyze user engagement patterns

user_idstring nullable

Filter by user ID

agent_idstring nullable

Filter by agent ID

team_idstring nullable

Filter by team ID

workflow_idstring nullable

Filter by workflow ID

start_timestring nullable

Filter sessions with traces created after this time (ISO 8601 format with timezone, e.g., '2025-11-19T10:00:00Z' or '2025-11-19T15:30:00+05:30'). Times are converted to UTC for comparison.

end_timestring nullable

Filter sessions with traces created before this time (ISO 8601 format with timezone, e.g., '2025-11-19T11:00:00Z' or '2025-11-19T16:30:00+05:30'). Times are converted to UTC for comparison.

pageinteger

Page number (1-indexed)

limitinteger

Number of sessions per page

db_idstring nullable

Database ID to query statistics from

Response

Trace statistics retrieved successfully

v1

Get Trace Statistics by Session

Query parameters

Response