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
}
]
}
Leads & Forms
List form responses
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
}
]
}
Lists submissions (“responses”) collected by a form.
Skipped/incomplete submissions are always excluded from this list.
Requires a Management API key with
MANAGEMENT_API (or MANAGEMENT_API_SANDBOX) quota, and the LEAD_GENERATION_ENTRY_CAN_VIEW permission, sent as the raw Authorization header value — see the Management API overview.string
required
The form’s
form_id.string
Filters to responses submitted through a specific QR Code, by
qrid.string
Only responses created on or after this date (
YYYY-MM-DD).string
Only responses created on or before this date (
YYYY-MM-DD).string
Substring search across submitted answers and the linked QR Code’s name.
string
created or -created. Default is -created.integer
Page number.
integer
Results per page, up to 200. Default 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 if form_id isn’t owned by this account.
If this form was converted from a legacy lead list, responses collected before the conversion are transparently merged into this same list — response
ids in that case can come from either the current form-response store or the legacy lead-entry store, but the shape returned is identical either way.Related
- Delete a form response — remove one response.
- Bulk-delete form responses — remove many at once.
- Export form responses — download responses as CSV/XLSX.
- 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. api.scanova.io) — the same key sent to the regular API host will not authenticate.
Response
200
Paginated list of form submissions.
Was this page helpful?