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

# List conversations



## OpenAPI

````yaml /openapi.json get /conversations
openapi: 3.0.0
info:
  title: Visito API
  version: 1.0.0
servers: []
security: []
paths:
  /conversations:
    get:
      tags:
        - Conversations
      summary: List conversations
      parameters:
        - schema:
            type: integer
            minimum: 1
            maximum: 100
            description: Max number of conversations to return (1–100).
            example: 25
          required: false
          description: Max number of conversations to return (1–100).
          name: limit
          in: query
        - schema:
            type: string
            description: >-
              Pagination cursor returned by the previous request. Pass it to
              fetch the next page.
            example: eyJpZCI6IjY4NTA1Y2I5MmExMWVhOTcxZDlkZjg5NCJ9
          required: false
          description: >-
            Pagination cursor returned by the previous request. Pass it to fetch
            the next page.
          name: cursor
          in: query
        - schema:
            type: string
            enum:
              - createdAt
              - updatedAt
            description: Sort conversations by creation date or last update date.
            example: updatedAt
          required: false
          description: Sort conversations by creation date or last update date.
          name: sortBy
          in: query
        - schema:
            type: string
            enum:
              - whatsapp
              - messenger
              - instagram
              - airbnb
              - voice
              - webchat
              - playground
            description: Filter by conversation channel.
            example: whatsapp
          required: false
          description: Filter by conversation channel.
          name: channel
          in: query
        - schema:
            type: string
            description: Filter by intent key.
            example: booking_inquiry
          required: false
          description: Filter by intent key.
          name: intent
          in: query
        - schema:
            type: string
            description: >-
              Search text across contact full name, phone number, and summary
              preview.
            example: late checkout
          required: false
          description: >-
            Search text across contact full name, phone number, and summary
            preview.
          name: q
          in: query
      responses:
        '200':
          description: A list of available conversations
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/Conversation'
                    description: List of conversations.
                  meta:
                    type: object
                    properties:
                      pagination:
                        $ref: '#/components/schemas/Pagination'
                    required:
                      - pagination
                required:
                  - data
                  - meta
      security:
        - bearerAuth: []
components:
  schemas:
    Conversation:
      type: object
      properties:
        id:
          type: string
          example: 68505cb92a11ea971d9df894
          description: Conversation ID
        fullName:
          type: string
          nullable: true
          example: Sofia Martinez
          description: Contact full name (if available)
        phoneNumber:
          type: string
          nullable: true
          example: '+524441234567'
          description: Contact phone number (if available)
        createdAt:
          type: string
          nullable: true
          format: date
          example: '2025-11-27T00:00:00.000Z'
          description: When the conversation was created (ISO 8601)
        updatedAt:
          type: string
          nullable: true
          format: date
          example: '2025-11-27T16:00:00.000Z'
          description: When the conversation was last updated (ISO 8601)
        channel:
          type: string
          enum:
            - whatsapp
            - instagram
            - webchat
          example: whatsapp
          description: Channel type for this conversation
        summary:
          type: string
          nullable: true
          example: Guest asked about late checkout and breakfast options.
          description: Latest conversation summary/preview text.
        intent:
          type: string
          nullable: true
          example: booking_inquiry
          description: Detected high-level intent for this conversation.
      required:
        - id
        - createdAt
        - updatedAt
        - channel
    Pagination:
      type: object
      properties:
        limit:
          type: integer
          minimum: 1
          maximum: 100
          description: Limit used for this page.
          example: 25
        nextCursor:
          type: string
          nullable: true
          description: Cursor for the next page (null if there is no next page).
          example: 68505cb92a11ea971d9df894
        hasMore:
          type: boolean
          description: Whether more results are available.
          example: true
      required:
        - limit
        - nextCursor
        - hasMore
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API Key
      description: 'Use `Authorization: Bearer <api_key>`.'

````