> ## Documentation Index > Fetch the complete documentation index at: https://docs.formbharo.artpark.ai/llms.txt > Use this file to discover all available pages before exploring further. # List Conversations > Return an agent's conversations: form data and recording availability, newest first. Add ``limit`` or ``cursor`` to page. Set ``include_transcript=true`` to include each row's transcript (off by default); when off, ``transcript`` and ``has_transcript`` are absent from the row, not empty. ## OpenAPI ````yaml /api-reference/openapi.json get /api/v1/agents/{agent_id}/conversations openapi: 3.1.0 info: description: > Create and run form-filling voice agents, and read back the conversations they had. Send your API key on every request as `Authorization: Bearer fb_live_...`. A key belongs to one workspace and only reaches that workspace's agents. Create and revoke keys from Settings in the web app; keys cannot manage other keys. title: FormBharo API version: 1.0.0 servers: - description: Production url: https://form-fill-agent-backend.artpark.ai security: - apiKey: [] paths: /api/v1/agents/{agent_id}/conversations: get: tags: - Agents summary: List Conversations description: |- Return an agent's conversations: form data and recording availability, newest first. Add ``limit`` or ``cursor`` to page. Set ``include_transcript=true`` to include each row's transcript (off by default); when off, ``transcript`` and ``has_transcript`` are absent from the row, not empty. operationId: list_conversations_api_v1_agents__agent_id__conversations_get parameters: - in: path name: agent_id required: true schema: title: Agent Id type: string - description: >- Maximum conversations to return. Sending this switches the response to the paged object shape. in: query name: limit required: false schema: anyOf: - minimum: 1 type: integer - type: 'null' description: >- Maximum conversations to return. Sending this switches the response to the paged object shape. title: Limit - description: >- Where to resume from: the ``next_cursor`` of the previous page. Sending this switches the response to the paged object shape. in: query name: cursor required: false schema: anyOf: - minimum: 0 type: integer - type: 'null' description: >- Where to resume from: the ``next_cursor`` of the previous page. Sending this switches the response to the paged object shape. title: Cursor - description: >- Only conversations created at or after this unix timestamp. Note: created_at is the last time the call's answers were written, not when the call happened, so a call edited later moves. in: query name: since required: false schema: anyOf: - type: number - type: 'null' description: >- Only conversations created at or after this unix timestamp. Note: created_at is the last time the call's answers were written, not when the call happened, so a call edited later moves. title: Since - description: >- Only conversations created at or before this unix timestamp. Note: created_at is the last time the call's answers were written, not when the call happened, so a call edited later moves. in: query name: until required: false schema: anyOf: - type: number - type: 'null' description: >- Only conversations created at or before this unix timestamp. Note: created_at is the last time the call's answers were written, not when the call happened, so a call edited later moves. title: Until - description: >- Only conversations with this status: complete, screened_out, failed, or in_progress. in: query name: status required: false schema: anyOf: - type: string - type: 'null' description: >- Only conversations with this status: complete, screened_out, failed, or in_progress. title: Status - description: Only conversations from this source (e.g. twilio, exotel). in: query name: source required: false schema: anyOf: - type: string - type: 'null' description: Only conversations from this source (e.g. twilio, exotel). title: Source - description: >- Include each call's transcript in its row. Off by default; then ``transcript`` and ``has_transcript`` are absent, not empty. in: query name: include_transcript required: false schema: default: false description: >- Include each call's transcript in its row. Off by default; then ``transcript`` and ``has_transcript`` are absent, not empty. title: Include Transcript type: boolean responses: '200': content: application/json: schema: anyOf: - items: $ref: '#/components/schemas/ConversationSummary' type: array - $ref: '#/components/schemas/models__ConversationPage' title: >- Response 200 List Conversations Api V1 Agents Agent Id Conversations Get description: Successful Response '422': content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' description: Validation Error security: - HTTPBearer: [] components: schemas: ConversationSummary: description: >- One row of the per-agent conversation list. ``transcript`` and ``has_transcript`` are both absent unless the request passed ``include_transcript=true``. ``has_recording``, ``has_events``, ``has_log`` and ``has_metrics`` say whether the call has ended rather than checking for each file: those files are only finalized at the end of a call, and checking every one of them for every call is what made this list slow. The per-conversation routes still answer 404 when a specific file genuinely is not there. The cost, duration and latency figures are deliberately not here for the same reason. They are on the cross-agent ``GET /conversations`` listing and in the analytics numbers. properties: caller_number: anyOf: - type: string - type: 'null' title: Caller Number conversation_id: title: Conversation Id type: string created_at: anyOf: - type: number - type: 'null' title: Created At filled_fields: title: Filled Fields type: integer form_data: additionalProperties: true title: Form Data type: object form_status: additionalProperties: true title: Form Status type: object has_events: title: Has Events type: boolean has_log: title: Has Log type: boolean has_metrics: title: Has Metrics type: boolean has_recording: title: Has Recording type: boolean has_transcript: anyOf: - type: boolean - type: 'null' title: Has Transcript is_ended: title: Is Ended type: boolean source: anyOf: - type: string - type: 'null' title: Source status: enum: - complete - screened_out - failed - in_progress title: Status type: string total_fields: title: Total Fields type: integer transcript: anyOf: - items: additionalProperties: true type: object type: array - type: 'null' title: Transcript required: - conversation_id - form_data - form_status - has_recording - has_events - is_ended - has_log - has_metrics - filled_fields - total_fields - status title: ConversationSummary type: object models__ConversationPage: description: >- Paged conversation list, returned only when ``limit`` or ``cursor`` is sent. properties: data: items: $ref: '#/components/schemas/ConversationSummary' title: Data type: array next_cursor: anyOf: - type: integer - type: 'null' title: Next Cursor required: - data title: ConversationPage type: object HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' title: Detail type: array title: HTTPValidationError type: object ValidationError: properties: loc: items: anyOf: - type: string - type: integer title: Location type: array msg: title: Message type: string type: title: Error Type type: string required: - loc - msg - type title: ValidationError type: object securitySchemes: apiKey: bearerFormat: fb_live_... scheme: bearer type: http ````