> ## Documentation Index > Fetch the complete documentation index at: https://docs.tavus.io/llms.txt > Use this file to discover all available pages before exploring further. # Get Conversation > This endpoint returns a single conversation by its unique identifier. For AI agents, use `https://docs.tavus.io/openapi.yaml` for the full HTTP API contract. ## OpenAPI ````yaml get /v2/conversations/{conversation_id} openapi: 3.0.3 info: title: Tavus Developer API Collection version: 1.0.0 contact: {} servers: - url: https://tavusapi.com security: - apiKey: [] tags: - name: Videos - name: Replicas - name: Voices - name: Conversations - name: Personas - name: Pronunciation Dictionaries - name: Replacements - name: Transcriptions - name: Documents paths: /v2/conversations/{conversation_id}: parameters: - name: conversation_id in: path required: true description: The unique identifier of the conversation. schema: type: string example: c123456 get: tags: - Conversations summary: Get Conversation description: | This endpoint returns a single conversation by its unique identifier. operationId: getConversation parameters: - name: verbose in: query required: false schema: type: boolean default: false description: > Append `verbose=true` to the URL to receive additional event data in the response, including: - `shutdown_reason`: The reason why the conversation ended (e.g., "participant_left_timeout") - `system.replica_joined`: When the replica joined the conversation - `system.shutdown`: When and why the conversation ended - `application.transcription_ready`: The end-of-call transcript. Each entry in `properties.transcript` has `role` (`user` / `assistant` / `system` / `tool`), `content`, `timestamp` (Unix epoch float, seconds), `seconds_from_start`, `duration` (seconds, float) and `inference_id` where available. - `application.perception_analysis`: The final visual analysis of the user that includes their appearance, behavior, emotional states, and screen activities This is particularly useful as an alternative to using the `callback_url` parameter on the [create conversation](/api-reference/conversations/create-conversation) endpoint for retrieving detailed conversation data. responses: '200': description: '' content: application/json: schema: type: object properties: conversation_id: type: string description: A unique identifier for the conversation. example: c123456 conversation_name: type: string description: The name of the conversation. example: A Meeting with Hassaan conversation_url: type: string description: A direct link to join the conversation. example: https://tavus.daily.co/c123456 callback_url: type: string description: >- The url that will receive webhooks with updates of the conversation state. example: https://yourwebsite.com/webhook status: type: string description: The status of the conversation. example: active replica_id: type: string description: >- A unique identifier for the replica used to create this conversation example: r90bbd427f71 persona_id: type: string description: >- A unique identifier for the persona used to create this conversation example: pcb7a34da5fe created_at: type: string description: The date and time the conversation was created. example: '' updated_at: type: string example: '' description: >- The date and time of when the conversation was last updated. events: type: array nullable: true description: >- When `verbose=true`, additional conversation events (e.g. shutdown, perception analysis payloads, end-of-call transcript). items: type: object properties: event_type: type: string description: >- Event name (e.g. system.replica_joined, application.transcription_ready, application.perception_analysis). timestamp: type: string description: ISO 8601 time of the event. properties: type: object additionalProperties: true description: >- Event-specific payload when present. For `application.transcription_ready`, includes a `transcript` array of per-turn entries. examples: default: summary: Default response (verbose omitted or false) value: conversation_id: c123456 conversation_name: A Meeting with Hassaan conversation_url: https://tavus.daily.co/c123456 callback_url: https://yourwebsite.com/webhook status: active replica_id: r90bbd427f71 persona_id: pcb7a34da5fe created_at: '2026-04-29T12:00:00Z' updated_at: '2026-04-29T12:05:00Z' verbose: summary: Example when verbose=true value: conversation_id: conv_123 status: ended replica_id: replica_abc persona_id: persona_xyz created_at: '2026-04-29T03:45:49Z' updated_at: '2026-04-29T03:47:01Z' events: - event_type: system.replica_joined timestamp: '2026-04-29T03:45:53Z' - event_type: application.transcription_ready timestamp: '2026-04-29T03:47:00Z' properties: transcript: - role: assistant content: Hi, welcome. What brought you here today? timestamp: 1779475657.84 seconds_from_start: 0 duration: 2.15 inference_id: inf_abc123 - role: user content: Just testing. timestamp: 1779475684.88 seconds_from_start: 27.04 duration: 1.84 - event_type: system.shutdown timestamp: '2026-04-29T03:47:01Z' properties: reason: participant_left_timeout '400': description: Bad Request content: application/json: schema: type: object properties: error: type: string description: The error message. example: Invalid conversation_id '401': description: UNAUTHORIZED content: application/json: schema: type: object properties: message: type: string description: The error message. example: Invalid access token security: - apiKey: [] components: securitySchemes: apiKey: type: apiKey in: header name: x-api-key ````