curl "https://api.scanova.io/media/?in_use=qr_logo" \
-H "Authorization: 401f7ac837da42b97f613d789819ff93537bee6a"
{
"count": 1,
"next": null,
"previous": null,
"results": [
{
"id": 4821,
"file": "media/uploads/104/2026/09/20260908_512873_logo.png",
"upload": null,
"file_name": "20260908_512873_logo.png",
"size": 48213,
"human_readable_size": "47.08 KB",
"original_name": "logo.png",
"bulk_media": null,
"mime_type": "image/png",
"file_type": "png",
"in_use": "qr_logo",
"category": "custom-design",
"created": "2026-09-08T10:15:32.120Z",
"modified": "2026-09-08T10:15:32.120Z"
}
]
}
Media Library
List uploaded files
GET /media/
GET
/
media
/
curl "https://api.scanova.io/media/?in_use=qr_logo" \
-H "Authorization: 401f7ac837da42b97f613d789819ff93537bee6a"
{
"count": 1,
"next": null,
"previous": null,
"results": [
{
"id": 4821,
"file": "media/uploads/104/2026/09/20260908_512873_logo.png",
"upload": null,
"file_name": "20260908_512873_logo.png",
"size": 48213,
"human_readable_size": "47.08 KB",
"original_name": "logo.png",
"bulk_media": null,
"mime_type": "image/png",
"file_type": "png",
"in_use": "qr_logo",
"category": "custom-design",
"created": "2026-09-08T10:15:32.120Z",
"modified": "2026-09-08T10:15:32.120Z"
}
]
}
Lists the account’s own uploaded files, on the Management API host (
api.scanova.io), authenticated with your raw Management API key.
GET https://api.scanova.io/media/
Authorization: 401f7ac837da42b97f613d789819ff93537bee6a
string
Filter by detected file type, e.g.
png.string
Filter by usage tag, e.g.
qr_logo.string
Filter by file extension.
string
Filter by MIME type.
boolean
Filter to files that are (or aren’t) part of a bulk media batch.
string
Search
original_name.string
Sort by
created, original_name, or file_size — prefix with - to reverse. Defaults to -created.string
Comma-separated field allow-list to trim the response shape.
integer
Page number.
integer
Results per page, max 100.
curl "https://api.scanova.io/media/?in_use=qr_logo" \
-H "Authorization: 401f7ac837da42b97f613d789819ff93537bee6a"
{
"count": 1,
"next": null,
"previous": null,
"results": [
{
"id": 4821,
"file": "media/uploads/104/2026/09/20260908_512873_logo.png",
"upload": null,
"file_name": "20260908_512873_logo.png",
"size": 48213,
"human_readable_size": "47.08 KB",
"original_name": "logo.png",
"bulk_media": null,
"mime_type": "image/png",
"file_type": "png",
"in_use": "qr_logo",
"category": "custom-design",
"created": "2026-09-08T10:15:32.120Z",
"modified": "2026-09-08T10:15:32.120Z"
}
]
}
This endpoint doesn’t reject unauthenticated calls outright — a missing or invalid API key simply scopes the query to no user, so you get an empty result set rather than a
401. Always send your key.Related
- Upload a file — add a new one.
- List allowed file types — the constraints uploads must satisfy.
- Retrieve a file — fetch one by id.
- Management API overview — the auth scheme and quota rules that apply to this endpoint.
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.
Query Parameters
e.g. -created, original_name, file_size.
Comma-separated field allow-list for the response.
Max 100.
Response
200 - application/json
Paginated list of files.
Was this page helpful?