Skip to main content

GET /api/v1/public/lead-lists/:id/leads/

Retrieve leads from a specific lead list with optional filtering, sorting, and pagination. Returns prospects for PEOPLE lists or companies for COMPANY lists. Auth: X-API-Key

Path Parameters

  • id (integer, required): Lead list ID

Query Parameters

You can also add any filter parameters as query strings (e.g., ?job_title=CEO&location=US).

Response (People List)

Response (Company List)

Sortable Fields

For People Lists

  • id - Prospect ID
  • first_name - First name
  • last_name - Last name
  • job_title - Job title
  • location - Location
  • created_at - Date added to list

For Company Lists

  • id - Company ID
  • name - Company name
  • industry - Industry
  • location - Location
  • amount_of_employees - Company size
  • revenue - Revenue

Error Responses

404 Not Found

Example Usage