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

# Lister les lead lists

> GET /lead/

Les lead lists sont la fonctionnalité de capture de leads d'origine de Scanova — une définition de formulaire (`data`) rattachée à la page de destination d'un QR code. Listez-les ou créez-en ici.

<Warning>
  Les Lead Lists sont une fonctionnalité **historique**. Le tableau de bord de Scanova oriente désormais les nouveaux cas d'usage de capture de leads vers les [Formulaires](/fr/api-reference/management-api/forms/create), qui couvrent le même cas d'usage « collecter des données de visiteurs à partir d'un scan de QR code » avec un outil de création plus performant. Les lead lists existantes continuent de fonctionner, et cet endpoint n'est pas affecté, mais construisez vos nouvelles intégrations sur les Formulaires, sauf si vous devez spécifiquement gérer une lead list préexistante.
</Warning>

<Note>
  Nécessite une clé Management API avec le quota `MANAGEMENT_API` (ou `MANAGEMENT_API_SANDBOX`), envoyée comme valeur brute de l'en-tête `Authorization` — voir la [vue d'ensemble de la Management API](/fr/api-reference/management-api/overview).
</Note>

<RequestExample>
  ```bash cURL theme={null}
  curl --request GET \
    --url 'https://management.scanova.io/lead/' \
    --header 'Authorization: YOUR_API_KEY'
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "count": 0,
    "next": null,
    "previous": null,
    "results": []
  }
  ```
</ResponseExample>

<Note>
  Vérifié en conditions réelles sur un compte de test sans lead list — d'où le `results` vide. Cet endpoint ne renvoie que les lead lists qui n'ont **pas** été converties en Formulaire ; une fois qu'une lead list est convertie (via le flux « Migrate to Form » du tableau de bord), elle disparaît définitivement de cette liste et devient uniquement accessible via les endpoints Formulaires.
</Note>

<ParamField query="is_active" type="boolean">
  Filtrer sur les lead lists actives (`true`) ou inactives (`false`). Les lead lists inactives n'affichent pas leur formulaire sur la page de destination.
</ParamField>

### Champs de réponse (par entrée)

<ResponseField name="id" type="integer" />

<ResponseField name="lead_id" type="string">
  Identifiant de lead list unique et immuable.
</ResponseField>

<ResponseField name="name" type="string">
  Nom interne — non affiché sur la page de destination publique.
</ResponseField>

<ResponseField name="is_active" type="boolean" />

<ResponseField name="usage_count" type="integer">
  Nombre de QR codes actuellement rattachés à cette lead list.
</ResponseField>

<ResponseField name="entries_count" type="integer">
  Nombre total de soumissions de leads collectées.
</ResponseField>

<ResponseField name="linked_qrs" type="array">
  QR codes auxquels cette lead list est rattachée.
</ResponseField>

<ResponseField name="created" type="string" />

<ResponseField name="modified" type="string" />

## Voir aussi

* [Créer une lead list](/fr/api-reference/management-api/leads/create) — l'autre opération de ce même endpoint.
* [Gestion des formulaires](/fr/api-reference/management-api/forms/create) — l'outil de capture de leads actuel et recommandé vers lequel cette fonctionnalité historique est orientée.
* [Vue d'ensemble de la Management API](/fr/api-reference/management-api/overview) — le schéma d'authentification et l'architecture de quotas dont fait partie cet endpoint.


## OpenAPI

````yaml api-reference/openapi/management-api.json 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.

````