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"
}
]
}
Management-API — Leads & Formulare
Formulare auflisten
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"
}
]
}
Formulare sind Scanovas aktueller Builder für Lead-Erfassung und Datensammlung — umfangreicher als die veraltete Funktion Lead-Listen und der empfohlene Weg, um Besucherdaten aus einem QR-Scan zu erfassen. Listen Sie sie hier auf oder erstellen Sie neue.
Erfordert einen Management-API-Schlüssel mit
MANAGEMENT_API- (oder MANAGEMENT_API_SANDBOX-)Quota, gesendet als roher Authorization-Header-Wert — siehe die Management-API-Übersicht.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] spiegeln hier eine echte, verifizierte Antwort gegen ein Test-Konto mit zwei Formularen wider.
boolean
Filtert auf aktive oder inaktive Formulare.
string
Inklusive Untergrenze (
YYYY-MM-DD) für created.string
Inklusive Obergrenze (
YYYY-MM-DD) für created.string
Teilstring-Abgleich gegen den Formularnamen.
string
created oder name, jeweils mit vorangestelltem - für absteigende Sortierung.Antwortfelder (pro Eintrag)
integer
string
Stabiler Formular-Bezeichner, verwendet in der öffentlichen Formular-URL und als Pfadparameter beim Abruf-/Aktualisierungs-/Löschungs-Endpunkt.
string
string | null
Anzeigename der Person, die das Formular erstellt hat.
string
Öffentliche URL, unter der das Formular gerendert wird.
boolean
integer
Anzahl der QR-Codes, mit denen dieses Formular derzeit verknüpft ist.
array
Mit diesem Formular verknüpfte QR-Codes, jeweils mit den
qr_code__*-Feldern des verknüpften QR-Codes und dessen aufgelöster Kurz-URL.integer | null
Gesamtzahl der erhaltenen Einsendungen.
null, wenn nicht berechenbar (z. B. war der datenbankübergreifende Tracking-Speicher nicht erreichbar).number | null
Prozentsatz der Scans über verknüpfte QR-Codes, die zu einer Einsendung führten.
null, wenn es noch keine Scans gab.string
string
Verwandte Themen
- Ein Formular erstellen — die andere Operation an diesem selben Endpunkt.
- Verwaltung von Lead-Listen — die veraltete Lead-Erfassungsfunktion, die Formulare ablösen.
- QR-Codes auflisten / erstellen — finden Sie die
qrid, die Sie beim Erstellen eines Formulars alsqr_idübergeben. - Management-API-Übersicht — das Auth-Schema und die Quota-Architektur, zu der dieser Endpunkt gehört.
Autorisierungen
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.
Antwort
200
List of forms
War diese Seite hilfreich?
⌘I