> ## Documentation Index > Fetch the complete documentation index at: https://docs.lighton.ai/llms.txt > Use this file to discover all available pages before exploring further. # List conversation turns in a thread > List all turns (answers) for a thread with cursor-based pagination. ## OpenAPI ````yaml /api-reference/openapi-v3.yaml get /api/v3/threads/{id}/turns openapi: 3.0.3 info: title: Paradigm API version: xenial-xerus (v3) description: >- A versatile and adaptable tool designed to integrate Generative AI into your applications servers: - url: https://paradigm.lighton.ai security: [] tags: - name: Agents description: Operations about agents - name: Threads description: Operations about agents conversation threads - name: Tools description: Operations about native tools - name: Models description: Operations about AI models - name: MCP description: Operations about MCP servers - name: Sources description: Operations about sources used by agents conversation threads - name: Artifacts description: Operations about artifacts generated by agents conversation threads - name: Agent description: >- Operations about agents (deprecated). Please use the 'Agents' API component instead. - name: Files description: Operations about files - name: Files Processing description: Operations about files processing - name: Tags description: Operations about tags - name: Workspaces description: Operations about workspaces - name: Users description: Operations about users - name: User Groups description: Operations about user groups - name: Companies description: Operations about companies - name: SCIM description: Operations about SCIM paths: /api/v3/threads/{id}/turns: get: tags: - Threads summary: List conversation turns in a thread description: List all turns (answers) for a thread with cursor-based pagination. operationId: api_v3_threads_turns_retrieve parameters: - in: query name: ending_before schema: type: string minLength: 1 description: ID to end pagination before - in: path name: id schema: type: string required: true - in: query name: limit schema: type: integer maximum: 100 minimum: 1 default: 10 - in: query name: starting_after schema: type: string minLength: 1 description: ID to start pagination after responses: '200': content: application/json: schema: $ref: '#/components/schemas/ListAnswerResponse' description: '' security: - bearerAuth: [] components: schemas: ListAnswerResponse: type: object properties: count: type: integer nullable: true next: type: string nullable: true previous: type: string nullable: true results: type: array items: $ref: '#/components/schemas/AnswerResponse' required: - count - next - previous - results AnswerResponse: type: object properties: id: type: string object: type: string default: turn thread: type: string status: $ref: '#/components/schemas/AnswerResponseStatusEnum' error: allOf: - $ref: '#/components/schemas/AnswerError' nullable: true messages: type: array items: $ref: '#/components/schemas/MessageResponse' created_at: type: string format: date-time liked: type: boolean nullable: true required: - created_at - id - messages - status - thread AnswerResponseStatusEnum: enum: - running - completed - failed - cancelled - cancelling type: string description: |- * `running` - running * `completed` - completed * `failed` - failed * `cancelled` - cancelled * `cancelling` - cancelling AnswerError: type: object properties: code: type: string nullable: true message: type: string nullable: true MessageResponse: type: object properties: id: type: string object: type: string default: message role: $ref: '#/components/schemas/MessageResponseRoleEnum' parts: type: array items: $ref: '#/components/schemas/MessagePartResponse' force_tool: allOf: - $ref: '#/components/schemas/ToolResponse' nullable: true immediate_final_answer: type: boolean nullable: true created_at: type: string format: date-time required: - created_at - id - parts - role MessageResponseRoleEnum: enum: - user - assistant type: string description: |- * `user` - user * `assistant` - assistant MessagePartResponse: type: object properties: type: $ref: '#/components/schemas/MessagePartResponseTypeEnum' text: type: string nullable: true reasoning: type: string nullable: true tool_call: allOf: - $ref: '#/components/schemas/ToolCallResponse' nullable: true document: allOf: - $ref: '#/components/schemas/DocumentPart' nullable: true workspace: allOf: - $ref: '#/components/schemas/WorkspacePart' nullable: true tag: allOf: - $ref: '#/components/schemas/Tag' nullable: true required: - type ToolResponse: type: object properties: id: type: string object: type: string default: tool name: type: string type: $ref: '#/components/schemas/Type310Enum' mcp_server_name: type: string nullable: true require_document: type: boolean nullable: true accepted_file_types: type: array items: type: string nullable: true required: - id - name - type MessagePartResponseTypeEnum: enum: - text - reasoning - tool_call - document - workspace - tag type: string description: |- * `text` - text * `reasoning` - reasoning * `tool_call` - tool_call * `document` - document * `workspace` - workspace * `tag` - tag ToolCallResponse: type: object properties: id: type: string object: type: string default: tool_call tool: $ref: '#/components/schemas/ToolResponse' tool_args: type: object additionalProperties: {} nullable: true steps: type: array items: $ref: '#/components/schemas/ToolStepResponse' nullable: true result: allOf: - $ref: '#/components/schemas/ToolCallResultResponse' nullable: true created_at: type: string format: date-time updated_at: type: string format: date-time required: - created_at - id - tool - updated_at DocumentPart: type: object properties: id: type: string required: - id WorkspacePart: type: object properties: id: type: string name: type: string nullable: true type: nullable: true oneOf: - $ref: '#/components/schemas/WorkspacePartTypeEnum' - $ref: '#/components/schemas/NullEnum' files_count: type: integer nullable: true required: - id Tag: type: object properties: id: type: integer description: Unique identifier for the tag tag: type: string description: Tag name required: - id - tag Type310Enum: enum: - native - mcp type: string description: |- * `native` - native * `mcp` - mcp ToolStepResponse: type: object properties: status: type: string progress_report: allOf: - $ref: '#/components/schemas/ProgressReportResponse' nullable: true created_at: type: string format: date-time required: - created_at - status ToolCallResultResponse: type: object properties: text: type: string nullable: true file_artifacts: type: array items: type: object additionalProperties: {} nullable: true web_sources: type: array items: type: object additionalProperties: {} nullable: true chunk_sources: type: array items: type: object additionalProperties: {} nullable: true document_sources: type: array items: type: object additionalProperties: {} nullable: true timings: type: object additionalProperties: type: number format: double nullable: true WorkspacePartTypeEnum: enum: - company - personal - custom type: string description: |- * `company` - company * `personal` - personal * `custom` - custom NullEnum: enum: - null ProgressReportResponse: type: object properties: progress_percentage: type: number format: double nullable: true current_progress_text: type: string nullable: true time_remaining_estimate: type: integer nullable: true metadata: type: object additionalProperties: {} nullable: true securitySchemes: bearerAuth: type: http scheme: bearer description: >- Bearer authentication header of the form `Bearer `, where `` is your auth token. ````