---
title: "Get Turn"
method: GET
path: "/assistant/sessions/{session_id}/turns/{turn_id}"
---

# Get Turn

`GET /assistant/sessions/{session_id}/turns/{turn_id}`

## Request

- Base URL: `https://api.retrodiffusion.ai/v2`
- URL: `https://api.retrodiffusion.ai/v2/assistant/sessions/{session_id}/turns/{turn_id}`
- Auth: none declared. Required headers: `X-RD-Token`

Poll one turn: status plus its accumulated events (messages, plan,
images, inspector notes).

## Path parameters

- `session_id` string, required
- `turn_id` string, required

## Headers

- `X-RD-Token` string, required

## Response `200`

Successful Response

- AssistantTurnRead
  - `id` string, required
  - `session_id` string, required
  - `kind` string, required
  - `status` string, required
  - `events` object[]
  - `plan` object
  - `charged_usd` number
  - `spent_usd` number
  - `error` string
  - `created_at` string, date-time
  - `updated_at` string, date-time

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `405`: Method not allowed.
- `422`: Validation Error
- `500`: Internal Server Error

---

[API](https://skmtc.dev/retrodiffusion/apis/retrodiffusion-api.md) · [All operations](https://skmtc.dev/retrodiffusion/apis/retrodiffusion-api/llms.txt) · [OpenAPI document](https://skmtc.dev/retrodiffusion/apis/retrodiffusion-api/revisions/9c76250e8e2d?raw)
