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

# Get Conversations

> Lists all conversations from your workspace inbox. Shows leads with active conversations. Supports pagination and filters.

## Overview

Lists all conversations from your workspace inbox. Shows leads with active conversations and supports pagination and multiple filters.

## Pagination

Results are paginated with 15 conversations per page. Use the `page` parameter (1-based) to navigate through pages.

## Filters

You can filter conversations by:

* **campaign**: Filter by campaign ID
* **account**: Filter by LinkedIn account ID
* **search**: Search by lead name or message content
* **read**: Filter by read status (true/false)
* **tag**: Filter by conversation tags
* **sentiment**: Filter by sentiment classification

## Use Cases

* Build a custom inbox interface
* Monitor conversations across all campaigns
* Filter conversations by specific criteria
* Search for specific leads or message content

## Response

Returns an array of conversation objects with pagination information. Each conversation includes:

* Basic lead information
* Last message preview
* Read status
* Associated campaign and account
* Tags and sentiment data


## OpenAPI

````yaml GET /v1/conversations
openapi: 3.1.0
info:
  title: WaLead API
  description: >-
    WaLead Public API for managing LinkedIn outreach campaigns, leads, and
    analytics
  version: 1.0.0
  contact:
    name: WaLead Support
    url: https://walead.ai
servers:
  - url: https://app-api.walead.ai/api
    description: Production server
security:
  - apiKeyAuth: []
paths:
  /v1/conversations:
    get:
      summary: Get Conversations
      description: >-
        Lists all conversations from your workspace inbox. Shows leads with
        active conversations. Supports pagination and filters.
      parameters:
        - name: page
          in: query
          description: Page number for pagination (1-based, 15 results per page)
          schema:
            type: string
        - name: campaign
          in: query
          description: Filter by campaign ID
          schema:
            type: string
        - name: account
          in: query
          description: Filter by LinkedIn account ID
          schema:
            type: string
        - name: search
          in: query
          description: Search conversations by lead name or message content
          schema:
            type: string
        - name: read
          in: query
          description: Filter by read status (true/false)
          schema:
            type: string
            enum:
              - 'true'
              - 'false'
        - name: tag
          in: query
          description: Filter by tag
          schema:
            type: string
        - name: sentiment
          in: query
          description: Filter by sentiment classification
          schema:
            type: string
      responses:
        '200':
          description: Conversations retrieved successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  conversations:
                    type: array
                    items:
                      $ref: '#/components/schemas/Conversation'
                  pagination:
                    type: object
                    properties:
                      page:
                        type: integer
                      total:
                        type: integer
        '401':
          description: Unauthorized - Invalid API Key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    Conversation:
      type: object
      properties:
        conversationUrn:
          type: string
          description: Unique conversation identifier
        leadId:
          type: string
          description: Associated lead ID
        leadName:
          type: string
          description: Lead's full name
        leadProfileUrl:
          type: string
          description: LinkedIn profile URL
        lastMessage:
          type: string
          description: Last message content
        lastMessageAt:
          type: string
          format: date-time
          description: Timestamp of last message
        read:
          type: boolean
          description: Whether the conversation is marked as read
        campaignId:
          type: string
          description: Associated campaign ID
        accountId:
          type: string
          description: Associated LinkedIn account ID
        tags:
          type: array
          items:
            type: string
          description: Conversation tags
        sentiment:
          type: string
          description: Sentiment classification
    Error:
      type: object
      required:
        - statusCode
        - message
      properties:
        statusCode:
          type: integer
          description: HTTP status code
        message:
          type: string
          description: Error message
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: API key for authentication. Generate from your WaLead dashboard.

````