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
Leads & Formulare
Formularantworten exportieren
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
Lädt Formularantworten als CSV- oder Excel-Datei herunter — entweder für ein Formular oder für alle Formulare, die mit einer Reihe von QR-Codes verknüpft sind.
Die Antwort ist ein Datei-Download (
Erfordert einen Management-API-Schlüssel mit
MANAGEMENT_API- (oder MANAGEMENT_API_SANDBOX-)Quota und die Berechtigung LEAD_GENERATION_ENTRY_CAN_VIEW, gesendet als roher Authorization-Header-Wert — siehe die Übersicht über die Management API.string
Exportiert die Antworten eines Formulars, mit seinem eigenen Fragenschema als Spaltenüberschriften. Schließt sich gegenseitig mit
qr_ids aus.array
Exportiert Antworten über alle Formulare (und umgewandelten Lead-Listen), die mit diesen QR-
qrids verknüpft sind — Fragen aus mehreren Formularen werden zu kombinierten Spalten zusammengeführt. Schließt sich gegenseitig mit form_id aus.string
Standard:"xls"
csv, xls oder xlsx.string
Nur Antworten, die an oder nach diesem Datum erstellt wurden (
YYYY-MM-DD).string
Nur Antworten, die an oder vor diesem Datum erstellt wurden (
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, oder der XLS/XLSX-MIME-Typ), kein JSON, mit Content-Disposition: attachment. Die Spalten sind Tracking ID, QR Code, Created, Skip, Source, eine Spalte pro Frage, dann acht Tracking-Abschlussspalten: Scan Time, Scan Day, Device Type, City, Country Code, Country Name, Postal Code, Region.
400, wenn sowohl form_id als auch qr_ids angegeben werden oder keines von beiden:
400
{ "detail": "form_id and qr_ids are mutually exclusive" }
400
{ "detail": "Either form_id or qr_ids is required" }
400, wenn file_format nicht csv, xls oder xlsx ist:
400
{ "detail": "Unknown file format" }
Verwandte Themen
- Formularantworten auflisten — das JSON-Äquivalent für ein einzelnes Formular, mit Filtern.
- Formularanalysen abrufen — aggregierte Zahlen statt Rohdatenzeilen.
- Übersicht über die Management API — das Authentifizierungsschema und die Quota-Architektur, zu der dieser Endpunkt gehört.
Autorisierungen
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.
Antwort
200
CSV or XLSX file download.
War diese Seite hilfreich?