Skip to main content
GET
Télécharge les entrées d’une liste de leads sous forme de fichier CSV ou Excel.
Nécessite une clé d’API de gestion avec le quota MANAGEMENT_API (ou MANAGEMENT_API_SANDBOX) et la permission LEAD_GENERATION_ENTRY_CAN_VIEW, envoyée comme valeur brute de l’en-tête Authorization — voir la présentation de l’API de gestion.
​
string
requis
Le lead_id de la liste de leads.
​
string
défaut:"csv"
csv, xls ou xlsx.
​
string
Uniquement les entrées créées à cette date ou après (YYYY-MM-DD).
​
string
Uniquement les entrées créées à cette date ou avant (YYYY-MM-DD).
​
string
UUID d’entrées séparés par des virgules pour limiter l’export à une sélection spécifique — reflète l’action « télécharger la sélection » du tableau de bord. Les UUID invalides sont silencieusement ignorés plutôt que rejetés.
​
string
La même recherche de sous-chaîne que Lister les entrées de leads — reflète « télécharger les résultats filtrés ».
La réponse est un téléchargement de fichier (Content-Type: text/csv, ou le type MIME XLSX pour xls/xlsx), pas du JSON, avec Content-Disposition: attachment; filename=<LeadListName>-<timestamp>.<ext>.
Le fichier exporté inclut toujours une colonne tracking_id, indépendamment des permissions de suivi ailleurs sur le compte. Si un code QR émetteur a depuis été supprimé, sa valeur de colonne s’affiche comme <qrid> (Deleted) plutôt que de faire échouer l’export. Avec zéro entrée correspondante, le fichier contient tout de même une ligne d’en-tête (dérivée des libellés de questions du formulaire de leads lui-même) plutôt que d’être vide.
Sur un compte au plan gratuit (plan_type 1), l’export est limité à 25 lignes — si plus d’entrées correspondaient, deux lignes finales sont ajoutées indiquant la limite et invitant à passer à une offre supérieure.
400 avec un corps en texte brut (pas la forme d’erreur DRF standard) si file_format n’est ni csv, xls, ni xlsx :
400

​
Voir aussi

Autorisations

​
Authorization
string
header
requis

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. api.scanova.io) — the same key sent to the regular API host will not authenticate.

Réponse

200

CSV or XLSX file download.