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
Clientes potenciales y formularios
Exportar respuestas de formulario
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
Descarga respuestas de formulario como un archivo CSV o Excel — ya sea para un formulario, o en todos los formularios vinculados a un conjunto de códigos QR.
La respuesta es una descarga de archivo (
Requiere una clave de API de gestión con cuota
MANAGEMENT_API (o MANAGEMENT_API_SANDBOX) y el permiso LEAD_GENERATION_ENTRY_CAN_VIEW, enviada como el valor sin procesar del encabezado Authorization — consulte el resumen de la API de gestión.string
Exporta las respuestas de un formulario, con su propio esquema de preguntas como encabezados de columna. Se excluye mutuamente con
qr_ids.array
Exporta respuestas de todos los formularios (y listas de leads convertidas) vinculados a estos
qrid de QR — las preguntas de varios formularios se combinan en columnas unificadas. Se excluye mutuamente con form_id.string
predeterminado:"xls"
csv, xls o xlsx.string
Solo respuestas creadas en o después de esta fecha (
YYYY-MM-DD).string
Solo respuestas creadas en o antes de esta fecha (
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, o el tipo MIME de XLS/XLSX), no JSON, con Content-Disposition: attachment. Las columnas son Tracking ID, QR Code, Created, Skip, Source, una columna por pregunta, y luego ocho columnas finales de seguimiento: Scan Time, Scan Day, Device Type, City, Country Code, Country Name, Postal Code, Region.
400 si se proporcionan tanto form_id como qr_ids, o ninguno de los dos:
400
{ "detail": "form_id and qr_ids are mutually exclusive" }
400
{ "detail": "Either form_id or qr_ids is required" }
400 si file_format no es csv, xls ni xlsx:
400
{ "detail": "Unknown file format" }
Relacionado
- Listar respuestas de formulario — el equivalente en JSON para un único formulario, con filtros.
- Obtener analíticas de formulario — números agregados en lugar de filas sin procesar.
- Resumen de la API de gestión — el esquema de autenticación y la arquitectura de cuotas a la que pertenece este endpoint.
Autorizaciones
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.
Respuesta
200
CSV or XLSX file download.
¿Esta página le ayudó?