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

# List conversations



## OpenAPI

````yaml /api-reference/openapi.json get /conversations
openapi: 3.1.0
info:
  title: Weav API
  version: 1.0.0
  description: |
    Public API for Weav workspace integrations.
    Base URL is versioned under /v1 and requires bearer token authentication.
    Token abilities are enforced:
    - `external-api:read` for read endpoints
    - `external-api:write` for write endpoints
    - `external-api:write` also grants read access
servers:
  - url: https://api.weav.com/v1
    description: Production
security:
  - bearerAuth: []
tags:
  - name: Agents
  - name: Companies
  - name: Conversations
  - name: Customers
  - name: Messages
  - name: Training Data
  - name: Webhooks
paths:
  /conversations:
    get:
      tags:
        - Conversations
      summary: List conversations
      operationId: listConversations
      parameters:
        - $ref: '#/components/parameters/perPage'
        - $ref: '#/components/parameters/page'
        - in: query
          name: status
          schema:
            type: string
            enum:
              - open
              - closed
        - in: query
          name: channel
          schema:
            type: string
            enum:
              - email
              - chat
      responses:
        '200':
          description: Paginated conversations
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaginatedConversations'
        '401':
          $ref: '#/components/responses/Unauthorized'
components:
  parameters:
    perPage:
      name: per_page
      in: query
      schema:
        type: integer
        minimum: 1
        maximum: 100
        default: 15
    page:
      name: page
      in: query
      schema:
        type: integer
        minimum: 1
        default: 1
  schemas:
    PaginatedConversations:
      type: object
      properties:
        data:
          type: array
          items:
            $ref: '#/components/schemas/Conversation'
        links:
          type: object
          additionalProperties: true
        meta:
          type: object
          additionalProperties: true
    Conversation:
      type: object
      properties:
        id:
          type: string
          format: uuid
        channel:
          type: string
          enum:
            - email
            - chat
        customer_id:
          type: string
          format: uuid
        subject:
          type: string
          nullable: true
        status:
          type: string
          enum:
            - open
            - closed
        priority:
          type: string
          enum:
            - low
            - normal
            - high
            - urgent
        assignee_id:
          type: string
          format: uuid
          nullable: true
          description: >
            User or agent UUID to assign. Must belong to the same workspace.

            For chat, agent assignment is limited to the conversation's original
            chat agent.

            For email, agent assignment is limited to the workspace active email
            agent.
        assignee_type:
          type: string
          enum:
            - user
            - agent
          nullable: true
        closed_at:
          type: string
          format: date-time
          nullable: true
        first_response_at:
          type: string
          format: date-time
          nullable: true
        last_message_at:
          type: string
          format: date-time
          nullable: true
        is_spam:
          type: boolean
        spam_score:
          type: number
          nullable: true
        created_at:
          type: string
          format: date-time
          nullable: true
        updated_at:
          type: string
          format: date-time
          nullable: true
    Error:
      type: object
      properties:
        error:
          type: string
          example: Error message
        code:
          type: string
          nullable: true
          example: UNAUTHENTICATED
        errors:
          type: object
          additionalProperties: true
          nullable: true
  responses:
    Unauthorized:
      description: Unauthorized
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API Token
      description: |
        Workspace API token.
        Include abilities `external-api:read` and/or `external-api:write`.

````