---
title: "Poll a submitted API-chat turn"
method: GET
path: "/test_framework/v1/runs/{id}/chat/{turn_id}/"
tags: ["Runs"]
---

# Poll a submitted API-chat turn

`GET /test_framework/v1/runs/{id}/chat/{turn_id}/`

## Request

- Base URL: `https://api.cekura.ai`
- URL: `https://api.cekura.ai/test_framework/v1/runs/{id}/chat/{turn_id}/`
- Auth: one of:
  - API key in header `X-CEKURA-API-KEY`
  - HTTP bearer
  - HTTP bearer
  - API key in header `X-VOCERA-SHAREABLE-LINK-TOKEN`
  - HTTP bearer

Poll for the simulated user's reply to a turn submitted via POST /runs/{run_id}/chat/. `status` is `generating` until the reply is ready, then `ready` (with `message` and `ended`). `dropped` means the turn was superseded by a newer submission — its message is kept and the newer turn's reply answers both; `error` means generation failed. Turn 0 is the run's opening: `message` is the evaluator's first message, or null when your agent speaks first. Any turn stays pollable until the run's turn history expires, so the last reply is still retrievable after the run finishes.

## Path parameters

- `id` integer, required
- `turn_id` string, required

## Response `200`

- ApiChatTurnPollResponse: Response for GET /runs/{run_id}/chat/{turn_id}/ (poll for the reply).
  - `run_id` integer, required
  - `result_id` integer, required
  - `turn_id` integer, required
  - `status` string, required: 'generating' until ready, then 'ready' (or 'error').
  - `message` string, nullable, required: The simulated user's reply; null until status is 'ready'.
  - `ended` boolean, required: True when the conversation has ended.
  - `ended_reason` string, nullable, required

## Other responses

- `404`: Unknown turn.

## Changes

- **2026-11-03** `a6fb6a739212`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/cekura/apis/cekura-api/changes/test_framework/v1/runs/:id/chat/:turn_id/get.md)

---

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