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

# List Conversations

> Get all conversations

## Endpoint

<Card>
  <strong>GET</strong> `/backend/conversations`
</Card>

## Query Parameters

<ParamField query="limit" type="integer" default="20">
  Number of conversations to return
</ParamField>

<ParamField query="offset" type="integer" default="0">
  Number of conversations to skip
</ParamField>

<ParamField query="lead_id" type="string">
  Filter by specific lead
</ParamField>

<ParamField query="status" type="string">
  Filter by status: `active`, `archived`
</ParamField>

## Request Example

<CodeGroup>
  ```bash cURL theme={null}
  curl -X GET "https://api.leavo.ai/backend/conversations?limit=50" \
    -H "Authorization: Bearer your_api_key_here"
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch('https://api.leavo.ai/backend/conversations?limit=50', {
    headers: {
      'Authorization': 'Bearer your_api_key_here'
    }
  });
  ```
</CodeGroup>

## Response

```json theme={null}
{
  "success": true,
  "data": [
    {
      "id": "conversation-uuid",
      "lead": {
        "id": "lead-uuid",
        "name": "John Smith",
        "phone": "+15551234567"
      },
      "last_message": {
        "content": "Thanks for the information!",
        "role": "user",
        "timestamp": "2024-01-15T14:30:00Z"
      },
      "unread_count": 2,
      "status": "active",
      "updated_at": "2024-01-15T14:30:00Z"
    }
  ],
  "pagination": {
    "total": 85,
    "limit": 50,
    "offset": 0,
    "has_more": true
  }
}
```