> ## Documentation Index > Fetch the complete documentation index at: https://docs.conduit.ai/llms.txt > Use this file to discover all available pages before exploring further. # Get Conversation > Retrieve details for a single conversation by its unique identifier. ## OpenAPI ````yaml GET /v1/conversations/{id} openapi: 3.0.0 info: title: Conduit API version: 1.0.0 description: Public API for Conduit. servers: - url: https://api.conduit.ai description: Production security: [] tags: - name: meta description: Discovery and API metadata endpoints. - name: agents description: >- V2 chat agent configuration, including instructions, skills, triggers, and automation behavior. - name: contacts description: >- Contact profile and contact-scoped related resources such as tickets and calls. - name: workspaces description: Workspaces accessible to the current API token. - name: escalations description: >- Chat escalations that require operator review, including message, proposed response, and disposition context when available. - name: conversations description: >- Canonical message threads. Use these endpoints to list threads, inspect conversation state, read transcripts, and send replies. - name: conversation-tags description: >- Conversation labels, root topics, and subtopics used for classification and topic analytics. - name: tickets description: >- Operational queue items tied to conversations, including ticket-scoped transcripts and replies. - name: calls description: Phone call records, transcripts, summaries, and recordings when available. - name: reservations description: >- PMS reservations synced from the workspace's integrations (Hostaway, Guesty, Airbnb, etc.), including guest identity, payment status, and stay dates. - name: appointments description: >- Scheduled appointments (bookings) backed by the Conduit booking service. Exposes allocation context and the upstream booking-service `external_id`. - name: helpdesk_tickets description: >- Helpdesk tickets mirrored from external helpdesk integrations (Zendesk, Pylon, Plain), including requester identity and upstream metadata. - name: kb description: >- Knowledge base search and node management. Nodes represent knowledge base entries (files or directories), chunks are the indexed retrieval units used by search. - name: skills description: >- Workspace agent skills that can be attached to V2 chat agents. Sidebar/global-assistant skills are intentionally excluded. - name: custom_tools description: >- Custom code tools: user-authored Python/JavaScript functions executed in a sandbox when an agent calls them. Includes a runtimes endpoint describing the entrypoint signature, return shape, and available dependencies per language. - name: inbox_types description: >- Workspace inbox types. Each id is stable and usable as a message trigger's `inboxTypeId` and as the `inbox_type_id` filter on list conversations. paths: /v1/conversations/{id}: get: tags: - conversations summary: Get conversation by id description: >- Returns conversation metadata for a single thread, including contact summary, ticket state, assignee, reservation context, summary, sentiment, and the latest message preview. operationId: getConversation parameters: - schema: type: string description: Canonical conversation id. example: ph77c0dy0mgdpzmqz6tesry8w184002s required: true name: id in: path - schema: type: string description: >- Optional workspace override. If omitted, Conduit resolves the conversation's workspace automatically. example: j57demo8f8x7c9v0n2q4r6t8y1u3i5o required: false name: workspace_id in: query responses: '200': description: Conversation content: application/json: schema: type: object properties: data: type: object properties: id: type: string workspace_id: type: string contact: type: object properties: id: type: string first_name: type: string last_name: type: string nullable: true image_url: type: string nullable: true inbox_type_id: type: string required: - id - first_name - last_name - image_url - inbox_type_id channel: type: string nullable: true archived: type: boolean ai_paused: type: boolean status: type: string nullable: true waiting_on: type: string nullable: true follow_up_at: type: string nullable: true assignee: type: object nullable: true properties: id: type: string name: type: string email: type: string picture_url: type: string nullable: true required: - id - name - email - picture_url reservation: type: object nullable: true properties: id: type: string listing_id: type: string status: type: string nullable: true guest_name: type: string nullable: true check_in: type: string check_out: type: string required: - id - listing_id - status - guest_name - check_in - check_out last_message_at: type: string nullable: true last_message_preview: type: string nullable: true created_at: type: string updated_at: type: string summary: type: string nullable: true sentiment: type: string nullable: true required: - id - workspace_id - contact - channel - archived - ai_paused - status - waiting_on - follow_up_at - assignee - reservation - last_message_at - last_message_preview - created_at - updated_at - summary - sentiment required: - data description: >- Conversation detail response. This endpoint returns conversation metadata and operational state, not the full transcript. example: data: id: ph77c0dy0mgdpzmqz6tesry8w184002s workspace_id: j57demo8f8x7c9v0n2q4r6t8y1u3i5o contact: id: ph77c0dy0mgdpzmqz6tesry8w184002s first_name: Jane last_name: Doe image_url: null inbox_type_id: guest channel: unthreaded_email archived: false ai_paused: false status: open waiting_on: customer follow_up_at: null assignee: id: m48k3v7p2q9x5t1w8r6n4j0y3u2i5o7a name: Alex M email: alex@example.com picture_url: null reservation: id: res_123 listing_id: listing_456 status: confirmed guest_name: Jane Doe check_in: '2026-04-08' check_out: '2026-04-12' last_message_at: '2026-04-03T03:14:15.000Z' last_message_preview: Can I check in early? created_at: '2026-04-01T17:22:10.000Z' updated_at: '2026-04-03T03:14:15.000Z' summary: Guest is asking about early check-in availability. sentiment: neutral '400': description: Invalid request content: application/json: schema: type: object properties: error: type: string required: - error description: Standard error response. example: error: Invalid workspace id '401': description: Unauthorized content: application/json: schema: type: object properties: error: type: string required: - error description: Standard error response. example: error: Invalid workspace id '403': description: Forbidden content: application/json: schema: type: object properties: error: type: string required: - error description: Standard error response. example: error: Invalid workspace id '404': description: Not found content: application/json: schema: type: object properties: error: type: string required: - error description: Standard error response. example: error: Invalid workspace id '429': description: Rate limit exceeded content: application/json: schema: type: object properties: error: type: string required: - error description: Standard error response. example: error: Invalid workspace id security: - bearerAuth: [] components: securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: API Token description: >- Conduit API token. Use `Authorization: Bearer `. Read/write endpoints require a token with write access. ````