---
title: "Get Conversation Turn"
method: GET
path: "/v1/convai/conversations/{conversation_id}/turns/{turn_id}"
tags: ["Agents Platform"]
---

# Get Conversation Turn

`GET /v1/convai/conversations/{conversation_id}/turns/{turn_id}`

## Request

- Base URL: `https://api.elevenlabs.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.elevenlabs.io/v1/convai/conversations/{conversation_id}/turns/{turn_id}`
- Auth: none declared
- TypeScript: <https://skmtc.dev/elevenlabs/apis/elevenlabs-api-documentation/docs/v1/convai/conversations/:conversation_id/turns/:turn_id/get.ts> (a function with typed inputs; its response is checked against the schema)

Get the status and output of a turn. The status comes from the stored transcript, so a turn that failed after the agent started can show as completed. Only the `stream_ended` event has the real outcome. This endpoint is in alpha and may change.

## Path parameters

- `conversation_id` string, required: The Conversation ID
- `turn_id` string, required: The Turn ID

## Headers

- `xi-api-key` string, nullable: Your API key. This is required by most endpoints to access our API programmatically. You can view your xi-api-key using the 'Profile' tab on the website.

## Response `200`

Successful Response

- ConversationTurn
  - `turn_id` string, required
  - `status` 'in_progress' | 'completed' | 'requires_action' | 'failed' | 'timed_out', required
  - `output` TextOutputItem[]
    - `type` 'text'
    - `role` 'agent', required
    - `id` string, nullable
    - `text` string, required
    - `created_at_unix_ms` integer, nullable
  - `error` AgentOutputError
    - `type` string, required
    - `code` string, required
    - `message` string, required
  - `required_actions` ClientToolCallRequiredAction[]: The actions the agent waits on. Answer each `client_tool_call` with a `client_tool_result` item in `input` to continue.
    - `type` 'client_tool_call'
    - `tool_call_id` string, required
    - `tool_name` string, required
    - `parameters` object, required
  - `stream_cursor` string, nullable: Resume token for this turn's event stream. Present while the turn is in progress; pass it as Last-Event-ID to stream the turn's events.

## Other responses

- `422`: Validation Error

## Changes

- **2026-11-12** `f2fab82c4571`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/elevenlabs/apis/elevenlabs-api-documentation/changes/v1/convai/conversations/:conversation_id/turns/:turn_id/get.md)

---

[API](https://skmtc.dev/elevenlabs/apis/elevenlabs-api-documentation.md) - [All operations](https://skmtc.dev/elevenlabs/apis/elevenlabs-api-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/elevenlabs/apis/elevenlabs-api-documentation/revisions/f2fab82c4571?raw)