curl --request GET \
--url 'https://management.scanova.io/folder/' \
--header 'Authorization: YOUR_API_KEY'
{
"count": 2,
"next": null,
"previous": null,
"results": [
{
"id": 41,
"name": "Product Launch",
"color": "#4F6BF4",
"created_by": 1029,
"folder_type": "qr",
"qr_codes_count": 12,
"created": "2026-07-01T09:12:04.221000+05:30",
"updated": "2026-07-14T16:03:11.884000+05:30"
},
{
"id": 40,
"name": "Retail Campaign",
"color": null,
"created_by": 1029,
"folder_type": "qr",
"qr_codes_count": 0,
"created": "2026-06-18T11:45:32.009000+05:30",
"updated": "2026-06-18T11:45:32.009000+05:30"
}
]
}
Management API — Folders & Tags
List folders
GET /folder/
GET
/
folder
/
curl --request GET \
--url 'https://management.scanova.io/folder/' \
--header 'Authorization: YOUR_API_KEY'
{
"count": 2,
"next": null,
"previous": null,
"results": [
{
"id": 41,
"name": "Product Launch",
"color": "#4F6BF4",
"created_by": 1029,
"folder_type": "qr",
"qr_codes_count": 12,
"created": "2026-07-01T09:12:04.221000+05:30",
"updated": "2026-07-14T16:03:11.884000+05:30"
},
{
"id": 40,
"name": "Retail Campaign",
"color": null,
"created_by": 1029,
"folder_type": "qr",
"qr_codes_count": 0,
"created": "2026-06-18T11:45:32.009000+05:30",
"updated": "2026-06-18T11:45:32.009000+05:30"
}
]
}
Folders group QR codes for organization — the same folders shown in the dashboard’s QR Codes > Folders sidebar. Use this endpoint to list an account’s folders or create a new one from your own systems.
Results are paginated (page size 10 by default, up to 100 via
Both operations require a Management API key with
MANAGEMENT_API (or MANAGEMENT_API_SANDBOX) quota, sent as the raw Authorization header value. See the Management API overview for authentication details.curl --request GET \
--url 'https://management.scanova.io/folder/' \
--header 'Authorization: YOUR_API_KEY'
{
"count": 2,
"next": null,
"previous": null,
"results": [
{
"id": 41,
"name": "Product Launch",
"color": "#4F6BF4",
"created_by": 1029,
"folder_type": "qr",
"qr_codes_count": 12,
"created": "2026-07-01T09:12:04.221000+05:30",
"updated": "2026-07-14T16:03:11.884000+05:30"
},
{
"id": 40,
"name": "Retail Campaign",
"color": null,
"created_by": 1029,
"folder_type": "qr",
"qr_codes_count": 0,
"created": "2026-06-18T11:45:32.009000+05:30",
"updated": "2026-06-18T11:45:32.009000+05:30"
}
]
}
page_size) and ordered newest first.
integer
Page number to retrieve.
integer
default:"10"
Number of folders per page. Maximum 100.
string
Filter to
qr (standard QR-code folders) or page (folders scoped to page-builder pages).string
Case-insensitive substring match against the folder name.
Response fields
integer
Folder ID — pass this as the
folder value when filtering QR analytics by folder, or when moving QR codes into the folder from the dashboard.string
Folder name. Unique per account and
folder_type.string | null
Hex color (e.g.
#4F6BF4) shown next to the folder in the sidebar, or null if unset.integer | null
User ID of whoever created the folder —
null if that user has since been removed from the account.string
qr or page.integer
Number of QR codes currently assigned to this folder.
string
ISO 8601 creation timestamp.
string
ISO 8601 timestamp of the last update.
Related
- Create a folder — the other operation on this same endpoint.
- Tag management — the other QR-organization mechanism, used alongside (or instead of) folders.
- List / create QR codes — filter QR codes by a folder ID returned here via
?folder=. - 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 folders
Was this page helpful?
⌘I