Skip to main content

​
Lead Lists API

The Lead Lists API allows you to manage lists of prospects or companies. You can search for leads using filters, add them to lists, retrieve them, and manage them programmatically.

​
Available Endpoints

​
Lead List Types

Seleqt supports two types of lead lists:
  1. PEOPLE Lists: For managing individual prospects/contacts
  2. COMPANY Lists: For managing companies/organizations
When creating a list, specify the search_type parameter to determine the list type. This affects which fields are available and how leads are stored.

​
GET /api/v1/public/lead-lists/

List all lead lists accessible with your API key.
  • Auth: X-API-Key
  • Optional query parameter: q or search for filtering by name

​
Example Request

curl -H "X-API-Key: <key>" \
  "https://api.seleqt.ai/api/v1/public/lead-lists/"

​
Response

{
  "success": true,
  "searches": [
    {
      "id": 123,
      "name": "Enterprise CEOs",
      "description": "",
      "total_prospects": 150,
      "status": "ACTIVE",
      "search_type": "PEOPLE",
      "created_at": "2025-10-08T11:22:33Z",
      "updated_at": "2025-10-08T14:30:00Z"
    },
    {
      "id": 124,
      "name": "SaaS Companies",
      "description": "",
      "total_prospects": 75,
      "status": "ACTIVE",
      "search_type": "COMPANY",
      "created_at": "2025-10-08T12:00:00Z",
      "updated_at": "2025-10-08T15:45:00Z"
    }
  ]
}

​
Quick Start

​
1. Create a Lead List

See Create Lead List for details. 
curl -X POST "https://api.seleqt.ai/api/v1/public/lead-lists/" \
  -H "X-API-Key: <key>" \
  -H "Content-Type: application/json" \
  -d '{"name": "Tech CEOs", "search_type": "PEOPLE"}'

​
2. Search for Leads

See Search Prospects for details. 
curl -X POST "https://api.seleqt.ai/api/v1/public/prospects/search/" \
  -H "X-API-Key: <key>" \
  -H "Content-Type: application/json" \
  -d '{
    "search_type": "PEOPLE",
    "filters": {
      "job_title": "CEO",
      "location": "United States",
      "industry": "Technology"
    }
  }'

​
3. Add Leads to List

See Add Leads for details. 
curl -X POST "https://api.seleqt.ai/api/v1/public/lead-lists/123/add-leads/" \
  -H "X-API-Key: <key>" \
  -H "Content-Type: application/json" \
  -d '{"prospect_ids": [12345, 12346, 12347]}'

​
4. Retrieve Leads from List

See Get Leads for details. 
curl "https://api.seleqt.ai/api/v1/public/lead-lists/123/leads/?page=1&page_size=50" \
  -H "X-API-Key: <key>"
For a complete workflow with code examples, see the Workflow Guide.