curl "https://api.scanova.io/media/bulk/12/" \
-H "Authorization: 401f7ac837da42b97f613d789819ff93537bee6a"
{
"id": 12,
"operation_id": "BM-9F3K2LQP",
"status": "new",
"count": 25,
"upload_count": 8,
"created": "2026-09-08T09:00:00Z",
"modified": "2026-09-08T09:05:00Z"
}
Media Library
Retrieve a bulk media batch
GET /media/bulk//
GET
/
media
/
bulk
/
{pk}
/
curl "https://api.scanova.io/media/bulk/12/" \
-H "Authorization: 401f7ac837da42b97f613d789819ff93537bee6a"
{
"id": 12,
"operation_id": "BM-9F3K2LQP",
"status": "new",
"count": 25,
"upload_count": 8,
"created": "2026-09-08T09:00:00Z",
"modified": "2026-09-08T09:05:00Z"
}
Retrieves one bulk media batch, on the Management API host (
Poll this endpoint to track upload progress against a batch —
api.scanova.io), authenticated with your raw Management API key.
GET https://api.scanova.io/media/bulk/{pk}/
Authorization: 401f7ac837da42b97f613d789819ff93537bee6a
integer
required
The batch’s
id, from List bulk media batches.curl "https://api.scanova.io/media/bulk/12/" \
-H "Authorization: 401f7ac837da42b97f613d789819ff93537bee6a"
{
"id": 12,
"operation_id": "BM-9F3K2LQP",
"status": "new",
"count": 25,
"upload_count": 8,
"created": "2026-09-08T09:00:00Z",
"modified": "2026-09-08T09:05:00Z"
}
upload_count increases as files are uploaded with this batch’s id, and status moves to completed once done. 404 if pk isn’t a batch owned by this account.
Related
- Update a bulk media batch — change the batch, e.g. mark it complete.
- Export a bulk media batch as CSV — download the batch’s file list.
- 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.
Path Parameters
Response
One batch.
Was this page helpful?