Skip to main content

​
Endpoint

GET /backend/leads

​
Query Parameters

​
limit
integer
default:"20"
Number of leads to return (max: 100)
​
offset
integer
default:"0"
Number of leads to skip
​
search
string
Search by name, email, or phone
​
status_id
string
Filter by status
​
tag_ids
string
Filter by tags (comma-separated)

​
Request Example

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

​
Response

{
  "success": true,
  "data": [
    {
      "id": "uuid",
      "name": "John Smith",
      "email": "[email protected]",
      "phone": "+15551234567",
      "company": "XYZ Company",
      "status": {
        "id": "uuid",
        "name": "New",
        "color": "#10B981"
      },
      "tags": [
        {
          "id": "uuid",
          "name": "VIP",
          "color": "#F59E0B"
        }
      ],
      "created_at": "2024-01-15T10:30:00Z",
      "updated_at": "2024-01-15T10:30:00Z"
    }
  ],
  "pagination": {
    "total": 150,
    "limit": 50,
    "offset": 0,
    "has_more": true
  }
}