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

# Retrieve a conversation

> Retrieve details of a specific conversation including messages



## OpenAPI

````yaml get /api/v2/conversations/{conversationId}
openapi: 3.0.1
info:
  title: LiveChatAI API v2
  description: >-
    LiveChatAI API v2 - Build powerful AI-powered customer support experiences.
    This API follows REST principles with predictable, resource-oriented URLs,
    JSON responses, and standard HTTP methods.
  version: 2.0.0
servers:
  - url: https://app.livechatai.com
    description: Production server
security:
  - bearerAuth: []
paths:
  /api/v2/conversations/{conversationId}:
    get:
      tags:
        - Conversations
      summary: Retrieve a conversation
      description: Retrieve details of a specific conversation including messages
      parameters:
        - in: path
          name: conversationId
          schema:
            type: string
            example: chat_1234567890
          required: true
          description: Unique identifier of the conversation to retrieve
      responses:
        '200':
          description: Successfully retrieved conversation details
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    example: success
                  data:
                    type: object
                    properties:
                      id:
                        type: string
                        example: chat_1234567890
                      contactId:
                        type: string
                        example: contact_1234567890
                      agentId:
                        type: string
                        example: clx1234567890abcdef
                      isResolved:
                        type: boolean
                        example: false
                      isAgent:
                        type: boolean
                        example: false
                      isMuted:
                        type: boolean
                        example: false
                      isStarred:
                        type: boolean
                        example: false
                      integrationType:
                        type: string
                        enum:
                          - WHATSAPP
                          - SLACK
                        nullable: true
                        example: WHATSAPP
                        description: Integration type of the conversation
                      lastMessageDate:
                        type: string
                        format: date-time
                        example: '2024-01-20T14:45:00Z'
                        description: Date of the last message (any sender)
                      lastVisitorMessageDate:
                        type: string
                        format: date-time
                        nullable: true
                        example: '2024-01-20T14:30:00Z'
                        description: Date of the last message from visitor
                      lastBotMessageDate:
                        type: string
                        format: date-time
                        nullable: true
                        example: '2024-01-20T14:45:00Z'
                        description: Date of the last message from AI bot
                      lastAgentMessageDate:
                        type: string
                        format: date-time
                        nullable: true
                        example: '2024-01-19T10:00:00Z'
                        description: Date of the last message from human agent
                      agent:
                        type: object
                        nullable: true
                        properties:
                          id:
                            type: string
                            example: agent_1234567890
                          name:
                            type: string
                            example: Jane Smith
                          email:
                            type: string
                            example: jane@company.com
                          avatar:
                            type: string
                            example: https://example.com/avatar.jpg
                      messages:
                        type: array
                        items:
                          type: object
                          properties:
                            id:
                              type: string
                              example: msg_1234567890
                            content:
                              type: string
                              example: What are your business hours?
                            role:
                              type: string
                              enum:
                                - user
                                - assistant
                              example: user
                            type:
                              type: string
                              example: TEXT
                              description: Type of the message
                              enum:
                                - TEXT
                                - IMAGE
                                - FILE
                            attachments:
                              type: array
                              description: Files attached to the message
                              items:
                                type: object
                                properties:
                                  id:
                                    type: string
                                  url:
                                    type: string
                                  name:
                                    type: string
                                  mimeType:
                                    type: string
                                  size:
                                    type: integer
                                  category:
                                    type: string
                                    enum:
                                      - image
                                      - video
                                      - audio
                                      - doc
                                      - text
                            source:
                              type: array
                              items:
                                type: object
                                properties:
                                  id:
                                    type: string
                                    example: src_1234567890
                                  type:
                                    type: string
                                    enum:
                                      - WEBSITE
                                      - TEXT
                                      - QA
                                      - PDF
                                      - YOUTUBE
                                      - DOCX
                                      - IMAGE
                                      - NOTION
                                    example: WEBSITE
                                  link:
                                    type: string
                                    example: https://example.com/page
                                  distance:
                                    type: number
                                    nullable: true
                                    example: 0.85
                              description: Sources used for generating the message response
                            agent:
                              type: object
                              nullable: true
                              properties:
                                id:
                                  type: string
                                  example: agent_1234567890
                                name:
                                  type: string
                                  example: Jane Smith
                                email:
                                  type: string
                                  example: jane@company.com
                                avatar:
                                  type: string
                                  example: https://example.com/avatar.jpg
                            createdAt:
                              type: string
                              format: date-time
                              example: '2024-01-15T10:30:00Z'
                      createdAt:
                        type: string
                        format: date-time
                        example: '2024-01-15T10:30:00Z'
                      updatedAt:
                        type: string
                        format: date-time
                        example: '2024-01-20T14:45:00Z'
        '401':
          description: Unauthorized access
        '403':
          description: Access denied - Invalid conversation access.
        '404':
          description: Conversation not found.
        '500':
          description: An internal server error occurred.
      security:
        - bearerAuth: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````