> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cekura.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Poll API Chat Turn

> Poll a submitted turn for the simulated user's reply.



## OpenAPI

````yaml get /test_framework/v1/runs/{id}/chat/{turn_id}/
openapi: 3.1.0
info:
  title: Cekura API
  version: v1
  description: >-
    Complete API documentation for the Cekura platform. This API provides
    endpoints for testing, observing, and evaluating AI voice agents — including
    managing agents, running evaluators, defining metrics, and analyzing call
    quality.
servers:
  - url: https://api.cekura.ai
security: []
paths:
  /test_framework/v1/runs/{id}/chat/{turn_id}/:
    get:
      tags:
        - Runs
      summary: Poll a submitted API-chat turn
      description: >-
        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.
      operationId: runs-api-chat-turn_2
      parameters:
        - in: path
          name: id
          schema:
            type: integer
          description: A unique integer value identifying this run.
          required: true
        - in: path
          name: turn_id
          schema:
            type: string
            pattern: ^[0-9]+$
          required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiChatTurnPollResponse'
          description: ''
        '404':
          description: Unknown turn.
      security:
        - api_key: []
components:
  schemas:
    ApiChatTurnPollResponse:
      type: object
      description: Response for GET /runs/{run_id}/chat/{turn_id}/ (poll for the reply).
      properties:
        run_id:
          type: integer
        result_id:
          type: integer
        turn_id:
          type: integer
        status:
          type: string
          description: '''generating'' until ready, then ''ready'' (or ''error'').'
        message:
          type:
            - string
            - 'null'
          description: The simulated user's reply; null until status is 'ready'.
        ended:
          type: boolean
          description: True when the conversation has ended.
        ended_reason:
          type:
            - string
            - 'null'
      required:
        - ended
        - ended_reason
        - message
        - result_id
        - run_id
        - status
        - turn_id
  securitySchemes:
    api_key:
      type: apiKey
      name: X-CEKURA-API-KEY
      in: header
      description: >-
        API Key Authentication. It should be included in the header of each
        request.

````