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

# List Lead Lists

> Retrieves all lead lists with optional filtering. Requires authentication.

## Overview

Retrieves all lead lists with optional filtering by active status. This endpoint allows you to get a paginated list of all lead lists in your account.

## Query Parameters

| Parameter   | Type    | Required | Description                        | Example           |
| ----------- | ------- | -------- | ---------------------------------- | ----------------- |
| `is_active` | boolean | No       | Filter lead lists by active status | `true` or `false` |

## Response

The response includes a paginated list of lead lists with the following structure:

* **`count`**: Total number of lead lists
* **`next`**: URL for next page (null if no more pages)
* **`previous`**: URL for previous page (null if first page)
* **`results`**: Array of lead list objects

## Lead List Object

Each lead list object contains:

* **`id`**: Internal lead list ID
* **`lead_id`**: Unique lead list identifier
* **`name`**: Name of the lead list
* **`created`**: Creation timestamp
* **`modified`**: Last modification timestamp
* **`is_active`**: Whether the lead list is active
* **`usage_count`**: Number of times this lead list has been used
* **`entries_count`**: Number of lead entries in this list
* **`linked_qrs`**: Array of QR codes linked to this lead list

## Examples

### Get All Lead Lists

```bash theme={null}
curl -X GET "https://management.scanova.io/lead/" \
  -H "Authorization: YOUR_API_KEY"
```

### Get Only Active Lead Lists

```bash theme={null}
curl -X GET "https://management.scanova.io/lead/?is_active=true" \
  -H "Authorization: YOUR_API_KEY"
```

### Get Only Inactive Lead Lists

```bash theme={null}
curl -X GET "https://management.scanova.io/lead/?is_active=false" \
  -H "Authorization: YOUR_API_KEY"
```

## Use Cases

* **Dashboard Overview**: Display all lead lists in your account
* **Active Management**: Filter to show only active lead lists
* **Analytics**: Get usage statistics for lead lists
* **QR Code Integration**: See which QR codes are linked to each lead list

<Note>
  Lead lists are used to capture user information when QR codes are scanned. Each lead list can be attached to multiple QR codes, but each QR code can only have one lead list attached.
</Note>


## OpenAPI

````yaml GET /lead/
openapi: 3.1.0
info:
  title: Scanova Management API (v2)
  description: >-
    The complete Scanova Management API — every endpoint available at
    management.scanova.io (QR codes, folders, tags, leads, forms, analytics,
    plans, shared users & roles), plus the token-creation and usage-stats
    endpoints used to authenticate against it. Every path and request/response
    shape below was verified live against a real API key and the actual running
    backend (Phase 7, 2026-08-16) — not guessed from reading urls.py alone.
  version: 2.0.0
servers:
  - url: https://management.scanova.io
    description: Management API — QR/folder/tag/lead/form/analytics/plans endpoints
security:
  - apiKeyAuth: []
paths:
  /lead/:
    get:
      summary: List lead lists
      operationId: listManagedLeadLists
      responses:
        '200':
          description: List of lead lists
components:
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: Authorization
      description: >-
        Send your Management API key as the raw value of the Authorization
        header — no "Bearer " or "Token " prefix, and no other characters.
        Example: `Authorization: 401f7ac837da42b97f613d789819ff93537bee6a`. A
        header containing more than one space-separated part is rejected
        outright. Requests also require the request's Host header to be the
        management API host (e.g. management.scanova.io) — the same key sent to
        the regular API host will not authenticate.

````