curl --request GET \
--url 'https://management.scanova.io/lead/' \
--header 'Authorization: YOUR_API_KEY'
{
"count": 0,
"next": null,
"previous": null,
"results": []
}
Management API — Leads & Forms
List lead lists
GET /lead/
GET
/
lead
/
curl --request GET \
--url 'https://management.scanova.io/lead/' \
--header 'Authorization: YOUR_API_KEY'
{
"count": 0,
"next": null,
"previous": null,
"results": []
}
Lead lists are Scanova’s original lead-capture feature — a form definition (
data) attached to a QR code’s landing page. List or create them here.
Lead Lists are a legacy feature. Scanova’s dashboard now steers new lead-capture use cases toward Forms instead, which cover the same “collect visitor data from a QR scan” use case with a more capable builder. Existing lead lists keep working, and this endpoint is unaffected, but build new integrations against Forms unless you specifically need to manage a pre-existing lead list.
Requires a Management API key with
MANAGEMENT_API (or MANAGEMENT_API_SANDBOX) quota, sent as the raw Authorization header value — see the Management API overview.curl --request GET \
--url 'https://management.scanova.io/lead/' \
--header 'Authorization: YOUR_API_KEY'
{
"count": 0,
"next": null,
"previous": null,
"results": []
}
Verified live against a test account with no lead lists — hence the empty
results. This endpoint only ever returns lead lists that have not been converted to a Form; once a lead list is converted (via the dashboard’s “Migrate to Form” flow), it drops out of this list permanently and becomes reachable only through the Forms endpoints.boolean
Filter to active (
true) or inactive (false) lead lists. Inactive lead lists don’t render their form on the landing page.Response fields (per entry)
integer
string
Unique, immutable lead-list identifier.
string
Internal name — not shown on the public landing page.
boolean
integer
Number of QR codes this lead list is currently attached to.
integer
Total number of lead submissions collected.
array
QR codes this lead list is attached to.
string
string
Related
- Create a lead list — the other operation on this same endpoint.
- Form management — the current, recommended lead-capture builder this legacy feature is being steered toward.
- Management API overview — the auth scheme and quota architecture this endpoint is part of.
Authorizations
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.
Response
200
List of lead lists
Was this page helpful?
⌘I