List Leads

Endpoint

GET /backend/leads

Query Parameters

integer

default:"20"

Number of leads to return (max: 100)

integer

default:"0"

Number of leads to skip

string

Search by name, email, or phone

string

Filter by status

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"

const response = await fetch('https://api.leavo.ai/backend/leads?limit=50&search=john', {
  headers: {
    'Authorization': 'Bearer your_api_key_here'
  }
});

const data = await response.json();

Response

{
  "success": true,
  "data": [
    {
      "id": "uuid",
      "name": "John Smith",
      "email": "john@example.com",
      "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
  }
}

Introduction Create Lead

Overview

Leads

Status

Tags

Knowledge Base

Pipeline (CRM)

Webhooks

Custom Fields

Cadences

Conversations

Messages

Departments

File Uploads

Templates (Meta/Gupshup)

Follow-up

Endpoint

Query Parameters

Request Example

Response

​Endpoint

​Query Parameters

​Request Example

​Response

Endpoint

Query Parameters

Request Example

Response