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

# Get Conversation

> Retrieve unified conversation history for a contact (messages, calls, tool calls, and interrupts)



## OpenAPI

````yaml GET /conversations/{contact_id}
openapi: 3.1.0
info:
  title: Outbox AI API
  description: API for managing AI agents (chatbots and voicebots) on the Outbox platform
  version: 1.0.0
servers:
  - url: https://api.getoutbox.ai
security: []
paths:
  /conversations/{contact_id}:
    get:
      summary: Get Conversation
      description: >-
        Retrieve unified conversation history for a contact (messages, calls,
        tool calls, and interrupts)
      parameters:
        - name: contact_id
          in: path
          description: The ID of the contact
          required: true
          schema:
            type: string
        - name: X-User-Timezone
          in: header
          description: User's timezone for timestamp formatting (defaults to UTC)
          required: false
          schema:
            type: string
        - name: page
          in: query
          description: Page number for pagination. Page size is 10 items.
          required: false
          schema:
            type: integer
            default: 1
      responses:
        '200':
          description: Conversation history retrieved successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConversationDetail'
        '401':
          description: Unauthorized - Invalid or missing API key
        '404':
          description: Contact not found
      security:
        - CompanyApiKey: []
components:
  schemas:
    ConversationDetail:
      type: object
      properties:
        contact:
          type: object
          properties:
            id:
              type: string
            name:
              type: string
            email:
              type: string
            phone:
              type: string
            tags:
              type: array
              items:
                type: string
        messages:
          type: array
          description: >-
            Unified conversation history with messages, calls, tool calls, and
            interrupts
          items:
            oneOf:
              - type: object
                properties:
                  type:
                    type: string
                    enum:
                      - message
                  id:
                    type: string
                  timestamp:
                    type: string
                    format: date-time
                    description: In user timezone
                  role:
                    type: string
                    enum:
                      - user
                      - assistant
                  message:
                    type: string
                  platform:
                    type: string
              - type: object
                properties:
                  type:
                    type: string
                    enum:
                      - call
                  id:
                    type: string
                  agent_name:
                    type: string
                  agent_id:
                    type: string
                  timestamp:
                    type: string
                    format: date-time
                    description: In user timezone
                  direction:
                    type: string
                    enum:
                      - inbound
                      - outbound
                  duration:
                    type: number
                    description: Duration in seconds
                  recording_url:
                    type: string
                  status:
                    type: string
              - type: object
                properties:
                  type:
                    type: string
                    enum:
                      - tool_call
                  id:
                    type: string
                  timestamp:
                    type: string
                    format: date-time
                    description: In user timezone
                  tool_name:
                    type: string
                  status:
                    type: string
              - type: object
                properties:
                  type:
                    type: string
                    enum:
                      - interrupt
                  timestamp:
                    type: string
                    format: date-time
                  message:
                    type: string
                  platform:
                    type: string
        pagination:
          type: object
          properties:
            page:
              type: integer
            total:
              type: integer
            has_next:
              type: boolean
            has_previous:
              type: boolean
  securitySchemes:
    CompanyApiKey:
      type: apiKey
      in: header
      name: Authorization
      description: Company API Key

````