Session Data

Access comprehensive data about your VoiceRun agents including conversation sessions, recordings, transcripts, and analytics.

View in app: https://app.voicerun.com/agents/{agentId}/sessions

Authentication#

All API requests require an API key. Generate one from your account settings.

Include the API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

https://api.voicerun.com/v1/agents/{agentId}/sessions

Retrieve a list of sessions for your agent.

GET /v1/agents/{agentId}/sessions

Parameter	Type	Description
`filters[agentId]`	string	Filter sessions by agent ID
`filters[agentEnvironmentId]`	string	Filter sessions by environment ID
`filters[status]`	string	Filter by session status (e.g., "completed", "in_progress")
`filters[createdAt][$gte]`	string	Filter sessions created after this date (ISO 8601)
`filters[createdAt][$lte]`	string	Filter sessions created before this date (ISO 8601)
`page`	number	Page number for pagination (default: 1)
`limit`	number	Number of results per page (default: 100, max: 1000)