> ## Documentation Index
> Fetch the complete documentation index at: https://docs.seleqt.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Lead lists

## 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

* **[GET /public/lead-lists/](#get-lead-lists)** - List all lead lists
* **[POST /public/lead-lists/](lead-lists-create-updated)** - Create a new lead list (people or company)
* **[POST /public/prospects/search/](prospects-search)** - Search and filter prospects or companies
* **[GET /public/lead-lists/:id/leads/](lead-lists-get-leads)** - Get leads from a list
* **[POST /public/lead-lists/:id/add-leads/](lead-lists-add-leads)** - Add leads to a list
* **[DELETE /public/lead-lists/:id/delete-leads/](lead-lists-delete-leads)** - Delete leads from a list
* **[GET /public/lead-lists/:id/enrichment/count/](lead-lists-enrichment-count)** - Get enrichment cost estimate
* **[POST /public/lead-lists/:id/enrichment/](lead-lists-enrichment)** - Enrich emails/phones for leads
* **[POST /public/lead-lists/:id/import/](lead-lists-import)** - Import leads from various sources
* **[Complete Workflow Guide](lead-lists-workflow)** - End-to-end examples

### 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

```bash theme={null}
curl -H "X-API-Key: <key>" \
  "https://api.seleqt.ai/api/v1/public/lead-lists/"
```

### Response

```json theme={null}
{
  "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](lead-lists-create-updated) for details.

```bash theme={null}
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](prospects-search) for details.

```bash theme={null}
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](lead-lists-add-leads) for details.

```bash theme={null}
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](lead-lists-get-leads) for details.

```bash theme={null}
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](lead-lists-workflow).