List Leads

Retrieve a paginated list of leads with optional filters.

Endpoint

GET /api/v1/leads

Query parameters

• directory_id - Filter by directory
• status - Filter by status (new, claimed, expired)
• from - Start date (ISO 8601)
• to - End date (ISO 8601)
• page - Page number (default: 1)
• limit - Items per page (default: 20, max: 100)

Response

{
  "data": [
    { "id": "lead_1", ... },
    { "id": "lead_2", ... }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 156,
    "pages": 8
  }
}