---
title: "Get Conversation Events"
method: GET
path: "/voice/conversations/{conversationId}/events"
tags: ["Voice Agent Conversations"]
---

# Get Conversation Events

`GET /voice/conversations/{conversationId}/events`

## Request

- Base URL: `https://api.speakai.co/v1`
- URL: `https://api.speakai.co/v1/voice/conversations/{conversationId}/events`
- Auth: API key in header `x-speakai-key` and API key in header `x-access-token`

### Get Conversation Events

Lists the raw turn-by-turn event log for one call (in chronological order): each transcript turn, tool call, and lifecycle transition the worker recorded during the call.

## Path parameters

- `conversationId` string, required

## Response `200`

OK

- object
  - `status` 'success'
  - `data` object
    - `events` object[]
      - `_id` string: MongoDB document id, included because every document has one; use eventId to identify it.
      - `eventId` string
      - `conversationId` string
      - `eventType` string: One of the voice call lifecycle event types (turn taken, tool called, handoff, etc).
      - `timestamp` string, date-time
      - `cost` number, nullable
      - `platformCost` number, nullable
      - `data` object: Event-type-specific payload. Shape varies by eventType.
      - `metadata` object
        - `requestId` string
        - `turnNumber` integer

## Other responses

- `404`: Conversation not found

---

[API](https://skmtc.dev/speakai/apis/speak-ai-api.md) · [All operations](https://skmtc.dev/speakai/apis/speak-ai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/speakai/apis/speak-ai-api/revisions/52d777e6d46e?raw)