curl --request GET \
--url 'https://api.scanova.io/lead/L9c2f4a1e/entry/export/?file_format=csv&from=2026-08-01&to=2026-08-31' \
--header 'Authorization: YOUR_API_KEY' \
--output entries.csv
Clientes potenciales y formularios
Exportar entradas de leads
GET /lead//entry/export/
GET
/
lead
/
{lead_id}
/
entry
/
export
/
curl --request GET \
--url 'https://api.scanova.io/lead/L9c2f4a1e/entry/export/?file_format=csv&from=2026-08-01&to=2026-08-31' \
--header 'Authorization: YOUR_API_KEY' \
--output entries.csv
Descarga las entradas de una lista de leads como un archivo CSV o Excel.
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
requerido
El
lead_id de la lista de leads.string
predeterminado:"csv"
csv, xls o xlsx.string
Solo entradas creadas en o después de esta fecha (
YYYY-MM-DD).string
Solo entradas creadas en o antes de esta fecha (
YYYY-MM-DD).string
UUIDs de entradas separados por comas para limitar la exportación a una selección específica — refleja la acción “descargar seleccionados” del panel. Los UUID inválidos se ignoran silenciosamente en lugar de rechazarse.
string
La misma búsqueda de subcadena que Listar entradas de leads — refleja “descargar resultados filtrados”.
curl --request GET \
--url 'https://api.scanova.io/lead/L9c2f4a1e/entry/export/?file_format=csv&from=2026-08-01&to=2026-08-31' \
--header 'Authorization: YOUR_API_KEY' \
--output entries.csv
Content-Type: text/csv, o el tipo MIME de XLSX para xls/xlsx), no JSON, con Content-Disposition: attachment; filename=<LeadListName>-<timestamp>.<ext>.
El archivo exportado siempre incluye una columna
tracking_id, independientemente de los permisos de seguimiento en cualquier otro lugar de la cuenta. Si un código QR emisor ha sido eliminado desde entonces, su valor de columna se representa como <qrid> (Deleted) en lugar de fallar la exportación. Con cero entradas coincidentes, el archivo aún contiene una fila de encabezado (derivada de las etiquetas de las preguntas del propio formulario de leads) en lugar de estar vacío.En una cuenta de plan gratuito (
plan_type 1), la exportación se limita a 25 filas — si hubiera más entradas coincidentes, se añaden dos filas finales indicando el límite e invitando a actualizar.400 con un cuerpo de texto sin formato (no la forma de error estándar de DRF) si file_format no es csv, xls o xlsx:
400
{ "detail": "requested file format unknown" }
Relacionado
- Listar entradas de leads — el equivalente en JSON, con los mismos filtros.
- 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ó?