docs.VoiceRun

Events

Access the full event history from your VoiceRun sessions. Events include all input and output events processed during a conversation (StartEvent, TextEvent, TextToSpeechEvent, etc.).

View in app: Open a session and select the Events tab.

See Authentication for API key setup.

Get Events#

Retrieve events for a specific session. Returns paginated results sorted by creation time descending.

GET /v1/sessions/{sessionId}/events

Query Parameters#

ParameterTypeDescription
pageintegerPage number (default: 1)
limitintegerItems per page (default: 100, max: 5000)
sortstringSort field and direction, e.g. timestamp,ASC (default: createdAt,DESC)

Example Response#

{
  "data": [
    {
      "id": "evt_abc123",
      "agentSessionId": "session_xyz",
      "name": "TextEvent",
      "data": { "content": "Hello", "source": "user" },
      "timestamp": "2025-04-01T10:00:00.000Z"
    }
  ],
  "metadata": {
    "page": 1,
    "limit": 100,
    "total": 147
  }
}

Related#

  • Transcripts — Get only transcript events (user and assistant speech)
  • Latency Metrics — Performance metrics included in session events
apisessionsevents