curl --request GET \
--url 'https://api.scanova.io/forms/F8a9b0c1d2e3f4g5h/responses/?ordering=-created' \
--header 'Authorization: YOUR_API_KEY'
{
"count": 3,
"next": null,
"previous": null,
"results": [
{
"id": "b3f1c9a2-1234-4d1a-9c6e-3a2b7f9d1e40",
"created": "2026-09-01T10:15:00Z",
"qr_code_id": "Q07afe81aa0034c01",
"qr_code_name": "docs-v2-first-qr-code",
"data": [
{ "question": "Full name", "answer": "Jane Doe" },
{ "question": "Email", "answer": "jane@example.com" }
],
"created_by": { "full_name": "Jane Doe", "email": "jane@example.com" },
"is_skipped": false
}
]
}
Clientes potenciales y formularios
Listar respuestas de formulario
GET /forms//responses/
GET
/
forms
/
{form_id}
/
responses
/
curl --request GET \
--url 'https://api.scanova.io/forms/F8a9b0c1d2e3f4g5h/responses/?ordering=-created' \
--header 'Authorization: YOUR_API_KEY'
{
"count": 3,
"next": null,
"previous": null,
"results": [
{
"id": "b3f1c9a2-1234-4d1a-9c6e-3a2b7f9d1e40",
"created": "2026-09-01T10:15:00Z",
"qr_code_id": "Q07afe81aa0034c01",
"qr_code_name": "docs-v2-first-qr-code",
"data": [
{ "question": "Full name", "answer": "Jane Doe" },
{ "question": "Email", "answer": "jane@example.com" }
],
"created_by": { "full_name": "Jane Doe", "email": "jane@example.com" },
"is_skipped": false
}
]
}
Lista los envíos (“respuestas”) recopilados por un formulario.
Los envíos omitidos/incompletos siempre se excluyen de esta lista.
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
form_id del formulario.string
Filtra las respuestas enviadas a través de un código QR específico, por
qrid.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).string
Búsqueda de subcadena en las respuestas enviadas y el nombre del código QR vinculado.
string
created o -created. El valor predeterminado es -created.integer
Número de página.
integer
Resultados por página, hasta 200. Predeterminado 20.
curl --request GET \
--url 'https://api.scanova.io/forms/F8a9b0c1d2e3f4g5h/responses/?ordering=-created' \
--header 'Authorization: YOUR_API_KEY'
{
"count": 3,
"next": null,
"previous": null,
"results": [
{
"id": "b3f1c9a2-1234-4d1a-9c6e-3a2b7f9d1e40",
"created": "2026-09-01T10:15:00Z",
"qr_code_id": "Q07afe81aa0034c01",
"qr_code_name": "docs-v2-first-qr-code",
"data": [
{ "question": "Full name", "answer": "Jane Doe" },
{ "question": "Email", "answer": "jane@example.com" }
],
"created_by": { "full_name": "Jane Doe", "email": "jane@example.com" },
"is_skipped": false
}
]
}
404 si form_id no pertenece a esta cuenta.
Si este formulario se convirtió a partir de una lista de leads heredada, las respuestas recopiladas antes de la conversión se fusionan de forma transparente en esta misma lista — los
id de respuesta en ese caso pueden provenir del almacén de respuestas de formulario actual o del almacén de entradas de leads heredado, pero la forma devuelta es idéntica en ambos casos.Relacionado
- Eliminar una respuesta de formulario — eliminar una respuesta.
- Eliminar respuestas de formulario masivamente — eliminar varias a la vez.
- Exportar respuestas de formulario — descargar respuestas como CSV/XLSX.
- 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
Paginated list of form submissions.
¿Esta página le ayudó?