curl --request GET \
--url 'https://management.scanova.io/tag/list/' \
--header 'Authorization: YOUR_API_KEY'
{
"count": 1,
"next": null,
"previous": null,
"results": [
{
"id": 3369,
"name": "docs-v2-test-tag"
}
]
}
Management API — Folders & Tags
Tag management
GET /tag/list/
GET
/
tag
/
list
/
curl --request GET \
--url 'https://management.scanova.io/tag/list/' \
--header 'Authorization: YOUR_API_KEY'
{
"count": 1,
"next": null,
"previous": null,
"results": [
{
"id": 3369,
"name": "docs-v2-test-tag"
}
]
}
Tags are the labels attached to QR codes for filtering and reporting — the same tags shown as chips throughout the dashboard’s QR Codes list. This endpoint returns the tags visible to the authenticated account, read-only.
Results are paginated (page size 10 by default, up to 100 via
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.List tags
curl --request GET \
--url 'https://management.scanova.io/tag/list/' \
--header 'Authorization: YOUR_API_KEY'
{
"count": 1,
"next": null,
"previous": null,
"results": [
{
"id": 3369,
"name": "docs-v2-test-tag"
}
]
}
page_size).
string
Case-insensitive prefix match — returns tags whose name starts with this value.
integer
Page number to retrieve.
integer
default:"10"
Number of tags per page. Maximum 100.
Response fields
integer
Tag ID.
string
Tag name, always returned lowercase regardless of how it was originally entered.
This list scopes to tags actually attached to (or assignable against) the account’s own QR codes — it is not a global tag directory. If the account has tag-based shared-user permissions enabled, the set returned can additionally depend on which tags the authenticated account is scoped to.
There is no corresponding create/delete endpoint on the Management API — tags are created implicitly when attached to a QR code (via the dashboard, the QR create/update endpoints, or bulk operations), not through a standalone tag-management call.
Related
- Folder management — the other QR-organization mechanism, used alongside (or instead of) tags.
- List / create QR codes — filter QR codes by tag name via
?tags=. - Shared user management — where a tag ID from this list is used to scope a teammate’s visibility.
- Roles & permissions — how tag-based permission scoping works from the dashboard side.
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 tags
Was this page helpful?
⌘I