curl --request POST \
--url 'https://api.scanova.io/forms/export/?file_format=csv&from=2026-08-01&to=2026-08-31' \
--header 'Authorization: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{ "form_id": "F8a9b0c1d2e3f4g5h" }' \
--output responses.csv
Prospects et formulaires
Exporter les réponses de formulaire
POST /forms/export/
POST
/
forms
/
export
/
curl --request POST \
--url 'https://api.scanova.io/forms/export/?file_format=csv&from=2026-08-01&to=2026-08-31' \
--header 'Authorization: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{ "form_id": "F8a9b0c1d2e3f4g5h" }' \
--output responses.csv
Télécharge les réponses de formulaire sous forme de fichier CSV ou Excel — soit pour un formulaire, soit sur tous les formulaires liés à un ensemble de codes QR.
La réponse est un téléchargement de fichier (
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
Exporte les réponses d’un formulaire, avec son propre schéma de questions comme en-têtes de colonnes. S’exclut mutuellement avec
qr_ids.array
Exporte les réponses de tous les formulaires (et listes de leads converties) liés à ces
qrid de QR — les questions de plusieurs formulaires sont fusionnées en colonnes combinées. S’exclut mutuellement avec form_id.string
défaut:"xls"
csv, xls ou xlsx.string
Uniquement les réponses créées à cette date ou après (
YYYY-MM-DD).string
Uniquement les réponses créées à cette date ou avant (
YYYY-MM-DD).curl --request POST \
--url 'https://api.scanova.io/forms/export/?file_format=csv&from=2026-08-01&to=2026-08-31' \
--header 'Authorization: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{ "form_id": "F8a9b0c1d2e3f4g5h" }' \
--output responses.csv
Content-Type: text/csv, ou le type MIME XLS/XLSX), pas du JSON, avec Content-Disposition: attachment. Les colonnes sont Tracking ID, QR Code, Created, Skip, Source, une colonne par question, puis huit colonnes finales de suivi : Scan Time, Scan Day, Device Type, City, Country Code, Country Name, Postal Code, Region.
400 si form_id et qr_ids sont tous deux fournis, ou aucun des deux :
400
{ "detail": "form_id and qr_ids are mutually exclusive" }
400
{ "detail": "Either form_id or qr_ids is required" }
400 si file_format n’est ni csv, xls, ni xlsx :
400
{ "detail": "Unknown file format" }
Voir aussi
- Lister les réponses de formulaire — l’équivalent JSON pour un seul formulaire, avec des filtres.
- Obtenir les analyses de formulaire — des chiffres agrégés plutôt que des lignes brutes.
- Présentation de l’API de gestion — le schéma d’authentification et l’architecture de quotas dont fait partie cet endpoint.
Autorisations
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.
Cette page vous a-t-elle été utile ?