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 gestion — Prospects et formulaires
Lister les formulaires
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"
}
]
}
Les formulaires sont l’outil actuel de Scanova pour la capture de leads et la collecte de données — plus riche que l’ancienne fonctionnalité Lead Lists, et la méthode recommandée pour collecter des données de visiteurs à partir d’un scan de QR code. Listez-les ou créez-en ici.
Nécessite une clé Management API avec le quota
MANAGEMENT_API (ou MANAGEMENT_API_SANDBOX), envoyée comme valeur brute de l’en-tête Authorization — voir la vue d’ensemble de la Management API.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] reflètent ici une réponse réelle vérifiée sur un compte de test possédant deux formulaires.
boolean
Filtrer sur les formulaires actifs ou inactifs.
string
Borne inférieure incluse (
YYYY-MM-DD) sur created.string
Borne supérieure incluse (
YYYY-MM-DD) sur created.string
Correspondance de sous-chaîne par rapport au nom du formulaire.
string
created ou name, préfixé de - pour un tri descendant.Champs de réponse (par entrée)
integer
string
Identifiant de formulaire stable, utilisé dans l’URL publique du formulaire et comme paramètre de chemin sur l’endpoint de récupération/mise à jour/suppression.
string
string | null
Nom affiché de la personne ayant créé le formulaire.
string
URL publique où le formulaire s’affiche.
boolean
integer
Nombre de QR codes actuellement liés à ce formulaire.
array
QR codes liés à ce formulaire, chacun avec les champs
qr_code__* du QR code lié et son URL courte résolue.integer | null
Nombre total de soumissions reçues.
null si ce nombre n’a pas pu être calculé (par ex. le magasin de suivi inter-bases de données était inaccessible).number | null
Pourcentage de scans, parmi les QR codes liés, ayant abouti à une soumission.
null s’il n’y a pas encore eu de scans.string
string
Voir aussi
- Créer un formulaire — l’autre opération de ce même endpoint.
- Gestion des lead lists — l’ancienne fonctionnalité de capture de leads que les Formulaires remplacent.
- Lister / créer des QR codes — trouvez le
qridà transmettre commeqr_idlors de la création d’un formulaire. - Vue d’ensemble de la Management API — le schéma d’authentification et l’architecture de quotas dont fait partie cet endpoint.
Autorisations
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.
Réponse
200
List of forms
Cette page vous a-t-elle été utile ?
⌘I