> ## 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. # List conversations for a contact > List conversations for a specific contact with pagination and filtering options. Mirrors the response shape of `GET /api/v2/conversations`, scoped to a single contact. ## OpenAPI ````yaml get /api/v2/contacts/{contactId}/conversations 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/contacts/{contactId}/conversations: get: tags: - Contacts summary: List conversations for a contact description: >- List conversations for a specific contact with pagination and filtering options. Mirrors the response shape of `GET /api/v2/conversations`, scoped to a single contact. parameters: - in: path name: contactId schema: type: string example: contact_1234567890 required: true description: Unique identifier of the contact - in: query name: page schema: type: integer default: 1 minimum: 1 example: 1 description: Page number for pagination - in: query name: perPage schema: type: integer default: 20 maximum: 100 minimum: 1 example: 20 description: Number of records per page (max 100) - in: query name: sort schema: type: string enum: - asc - desc default: desc example: desc description: Sort order for lastMessageDate - in: query name: status schema: type: string enum: - open - close example: open description: Filter by conversation status - in: query name: startDate schema: type: string example: '2024-01-01' description: >- Filter by start date. Supports Unix timestamp in seconds (e.g., 1747196400) or ISO 8601 format (e.g., 2024-01-01) - in: query name: endDate schema: type: string example: '2024-01-31' description: >- Filter by end date. Supports Unix timestamp in seconds (e.g., 1747200000) or ISO 8601 format (e.g., 2024-01-31) - in: query name: assignedTo schema: type: string example: user_1234567890 description: >- Filter by assigned agent ID. Use 'ai' for AI-handled conversations (no human agent assigned) - in: query name: sentiment schema: type: string enum: - POSITIVE - NEGATIVE - NEUTRAL - UNSPECIFIED example: POSITIVE description: Filter by conversation sentiment - in: query name: topic schema: type: string example: billing description: Filter by conversation topic name - in: query name: channel schema: type: string enum: - WHATSAPP - SLACK - MESSENGER - FULLPAGE - INLINECHAT - PREVIEW - ONBOARDING example: WHATSAPP description: Filter by conversation channel (integration type or chat type) - in: query name: resolutionStatus schema: type: string enum: - AIHelped - AIDidNotHelp - TalkToAgent example: AIHelped description: Filter by resolution status - in: query name: viewId schema: type: string example: view_1234567890 description: >- Filter using a saved inbox view ID. When provided, applies all filters configured in the inbox view. Other filters can be combined with viewId responses: '200': description: Successfully retrieved conversations list for the contact content: application/json: schema: type: object properties: status: type: string example: success data: type: object properties: conversations: type: array items: type: object properties: id: type: string example: chat_1234567890 isResolved: type: boolean example: false isStarred: type: boolean example: false isMuted: type: boolean example: false isAgent: type: boolean example: false integrationType: type: string example: WHATSAPP contact: type: object properties: id: type: string example: contact_1234567890 name: type: string example: John Doe phone: type: string example: '+1234567890' email: type: string example: john@example.com distinctId: type: string example: user_12345 attributes: type: object example: planType: premium 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 lastMessageDate: type: string format: date-time example: '2024-01-20T14:45:00Z' lastVisitorMessageDate: type: string format: date-time nullable: true example: '2024-01-20T14:30:00Z' lastBotMessageDate: type: string format: date-time nullable: true example: '2024-01-20T14:45:00Z' lastAgentMessageDate: type: string format: date-time nullable: true example: '2024-01-19T10:00: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' meta: type: object properties: total: type: integer example: 12 perPage: type: integer example: 20 currentPage: type: integer example: 1 totalPages: type: integer example: 1 '400': description: Bad request - Missing or invalid parameters '401': description: Unauthorized access '404': description: Contact not found '500': description: An internal server error occurred. security: - bearerAuth: [] components: securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: JWT ````