Skip to main content

​
Endpoint

GET /backend/conversations

​
Query Parameters

​
limit
integer
default:"20"
Number of conversations to return
​
offset
integer
default:"0"
Number of conversations to skip
​
lead_id
string
Filter by specific lead
​
status
string
Filter by status: active, archived

​
Request Example

curl -X GET "https://api.leavo.ai/backend/conversations?limit=50" \
  -H "Authorization: Bearer your_api_key_here"

​
Response

{
  "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
  }
}