curl --request GET \
--url 'https://management.scanova.io/forms/' \
--header 'Authorization: YOUR_API_KEY'
{
"count": 2,
"next": null,
"previous": null,
"results": [
{
"id": 375,
"form_id": "F7e1b1ad8f8d040e9",
"name": "docs-v2-contact-form",
"created_by": "Docs",
"created": "2026-08-16T20:33:41.950697+05:30",
"form_url": "https://new.scnv.io/form/F7e1b1ad8f8d040e9",
"is_active": true,
"usage_count": 1,
"linked_qrs": [
{
"qr_code__id": 9021,
"qr_code__qrid": "Q07afe81aa0034c01",
"qr_code__name": "docs-v2-first-qr-code",
"qr_code__qr_type": "dy",
"qr_code__is_active": true,
"qr_code__published_at": "2026-08-16T15:03:11.884000+05:30",
"qr_code__category__slug": "url",
"dynamic_url_object__short_url": "https://new.scnv.io/s/AbC123",
"qr_code__is_currently_draft": false
}
],
"entries_count": 3,
"conversion": 12.5,
"modified": "2026-08-16T20:33:41.950697+05:30"
},
{
"id": 374,
"form_id": "F1a2b3c4d5e6f7g8h",
"name": "Event RSVP",
"created_by": "Docs",
"created": "2026-08-01T09:15:02.001000+05:30",
"form_url": "https://new.scnv.io/form/F1a2b3c4d5e6f7g8h",
"is_active": true,
"usage_count": 0,
"linked_qrs": [],
"entries_count": 0,
"conversion": null,
"modified": "2026-08-01T09:15:02.001000+05:30"
}
]
}
API de gestión — Clientes potenciales y formularios
Listar formularios
GET /forms/
GET
/
forms
/
curl --request GET \
--url 'https://management.scanova.io/forms/' \
--header 'Authorization: YOUR_API_KEY'
{
"count": 2,
"next": null,
"previous": null,
"results": [
{
"id": 375,
"form_id": "F7e1b1ad8f8d040e9",
"name": "docs-v2-contact-form",
"created_by": "Docs",
"created": "2026-08-16T20:33:41.950697+05:30",
"form_url": "https://new.scnv.io/form/F7e1b1ad8f8d040e9",
"is_active": true,
"usage_count": 1,
"linked_qrs": [
{
"qr_code__id": 9021,
"qr_code__qrid": "Q07afe81aa0034c01",
"qr_code__name": "docs-v2-first-qr-code",
"qr_code__qr_type": "dy",
"qr_code__is_active": true,
"qr_code__published_at": "2026-08-16T15:03:11.884000+05:30",
"qr_code__category__slug": "url",
"dynamic_url_object__short_url": "https://new.scnv.io/s/AbC123",
"qr_code__is_currently_draft": false
}
],
"entries_count": 3,
"conversion": 12.5,
"modified": "2026-08-16T20:33:41.950697+05:30"
},
{
"id": 374,
"form_id": "F1a2b3c4d5e6f7g8h",
"name": "Event RSVP",
"created_by": "Docs",
"created": "2026-08-01T09:15:02.001000+05:30",
"form_url": "https://new.scnv.io/form/F1a2b3c4d5e6f7g8h",
"is_active": true,
"usage_count": 0,
"linked_qrs": [],
"entries_count": 0,
"conversion": null,
"modified": "2026-08-01T09:15:02.001000+05:30"
}
]
}
Los formularios son el generador actual de captura de leads y recopilación de datos de Scanova — más completo que la función heredada de Listas de leads, y la forma recomendada de recopilar datos del visitante desde un escaneo de QR. Listarlos o crearlos aquí.
Requiere una clave de la API de gestión con cuota
MANAGEMENT_API (o MANAGEMENT_API_SANDBOX), enviada como el valor sin procesar del encabezado Authorization — consulta el resumen de la API de gestión.curl --request GET \
--url 'https://management.scanova.io/forms/' \
--header 'Authorization: YOUR_API_KEY'
{
"count": 2,
"next": null,
"previous": null,
"results": [
{
"id": 375,
"form_id": "F7e1b1ad8f8d040e9",
"name": "docs-v2-contact-form",
"created_by": "Docs",
"created": "2026-08-16T20:33:41.950697+05:30",
"form_url": "https://new.scnv.io/form/F7e1b1ad8f8d040e9",
"is_active": true,
"usage_count": 1,
"linked_qrs": [
{
"qr_code__id": 9021,
"qr_code__qrid": "Q07afe81aa0034c01",
"qr_code__name": "docs-v2-first-qr-code",
"qr_code__qr_type": "dy",
"qr_code__is_active": true,
"qr_code__published_at": "2026-08-16T15:03:11.884000+05:30",
"qr_code__category__slug": "url",
"dynamic_url_object__short_url": "https://new.scnv.io/s/AbC123",
"qr_code__is_currently_draft": false
}
],
"entries_count": 3,
"conversion": 12.5,
"modified": "2026-08-16T20:33:41.950697+05:30"
},
{
"id": 374,
"form_id": "F1a2b3c4d5e6f7g8h",
"name": "Event RSVP",
"created_by": "Docs",
"created": "2026-08-01T09:15:02.001000+05:30",
"form_url": "https://new.scnv.io/form/F1a2b3c4d5e6f7g8h",
"is_active": true,
"usage_count": 0,
"linked_qrs": [],
"entries_count": 0,
"conversion": null,
"modified": "2026-08-01T09:15:02.001000+05:30"
}
]
}
count, results[0] aquí reflejan una respuesta real verificada contra una cuenta de prueba con dos formularios.
boolean
Filtra a formularios activos o inactivos.
string
Límite inferior inclusivo (
YYYY-MM-DD) sobre created.string
Límite superior inclusivo (
YYYY-MM-DD) sobre created.string
Coincidencia de subcadena con el nombre del formulario.
string
created o name, cualquiera de ellos precedido de - para orden descendente.Campos de la respuesta (por entrada)
integer
string
Identificador estable del formulario, usado en la URL pública del formulario y como parámetro de ruta en el endpoint de obtener/actualizar/eliminar.
string
string | null
Nombre para mostrar de quien creó el formulario.
string
URL pública donde se renderiza el formulario.
boolean
integer
Número de códigos QR a los que está vinculado actualmente este formulario.
array
Códigos QR vinculados a este formulario, cada uno con los campos
qr_code__* del QR vinculado y su URL corta resuelta.integer | null
Total de envíos recibidos.
null si no se pudo calcular (p. ej. el almacén de seguimiento entre bases de datos no estaba accesible).number | null
Porcentaje de escaneos en los códigos QR vinculados que resultaron en un envío.
null si aún no ha habido escaneos.string
string
Relacionado
- Crear un formulario — la otra operación de este mismo endpoint.
- Gestión de listas de leads — la función heredada de captura de leads que sustituyen los Formularios.
- Listar / crear códigos QR — encuentra el
qridque pasar comoqr_idal crear un formulario. - Resumen de la API de gestión — el esquema de autenticación y la arquitectura de cuotas de la que forma parte 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. management.scanova.io) — the same key sent to the regular API host will not authenticate.
Respuesta
200
List of forms
¿Esta página le ayudó?
⌘I