curl "https://api.scanova.io/bulk-operation/" \
-H "Authorization: 401f7ac837da42b97f613d789819ff93537bee6a"
{
"count": 1,
"next": null,
"previous": null,
"results": [
{
"operation_id": "bo-8f3a1c",
"name": "September event QR batch",
"count": 500,
"operation_type": "generate",
"operation_type_display": "Generate",
"status": "completed",
"created": "2026-09-08T09:00:00Z",
"result_file": "https://cdn.scanova.io/bulk/bo-8f3a1c/result.xlsx",
"progress": 100,
"error_message": null,
"log_file": "https://cdn.scanova.io/bulk/bo-8f3a1c/log.csv",
"failed_count": 0,
"folder": null,
"created_by": "Jane Doe",
"qr_category": "website-url"
}
]
}
Bulk Operations
List bulk operations
GET /bulk-operation/
GET
/
bulk-operation
/
curl "https://api.scanova.io/bulk-operation/" \
-H "Authorization: 401f7ac837da42b97f613d789819ff93537bee6a"
{
"count": 1,
"next": null,
"previous": null,
"results": [
{
"operation_id": "bo-8f3a1c",
"name": "September event QR batch",
"count": 500,
"operation_type": "generate",
"operation_type_display": "Generate",
"status": "completed",
"created": "2026-09-08T09:00:00Z",
"result_file": "https://cdn.scanova.io/bulk/bo-8f3a1c/result.xlsx",
"progress": 100,
"error_message": null,
"log_file": "https://cdn.scanova.io/bulk/bo-8f3a1c/log.csv",
"failed_count": 0,
"folder": null,
"created_by": "Jane Doe",
"qr_category": "website-url"
}
]
}
Lists tracking records for the account’s bulk operations, on the Management API host (
This is the endpoint every async bulk endpoint tells you to poll.
api.scanova.io), authenticated with your raw Management API key.
GET https://api.scanova.io/bulk-operation/
Authorization: 401f7ac837da42b97f613d789819ff93537bee6a
curl "https://api.scanova.io/bulk-operation/" \
-H "Authorization: 401f7ac837da42b97f613d789819ff93537bee6a"
{
"count": 1,
"next": null,
"previous": null,
"results": [
{
"operation_id": "bo-8f3a1c",
"name": "September event QR batch",
"count": 500,
"operation_type": "generate",
"operation_type_display": "Generate",
"status": "completed",
"created": "2026-09-08T09:00:00Z",
"result_file": "https://cdn.scanova.io/bulk/bo-8f3a1c/result.xlsx",
"progress": 100,
"error_message": null,
"log_file": "https://cdn.scanova.io/bulk/bo-8f3a1c/log.csv",
"failed_count": 0,
"folder": null,
"created_by": "Jane Doe",
"qr_category": "website-url"
}
]
}
status moves from new to completed, partially_completed, or failed; progress is a 0–100 completion percentage. Once status isn’t new, result_file and log_file (when relevant) hold download URLs.
Scope: the account’s own operations, plus — for team accounts — operations created by any shared user, unless the call is made via account impersonation, in which case scope narrows to just the impersonated user.
Related
- Get bulk operation stats — aggregate counts over this same list.
- Rename a bulk operation — relabel an entry here.
- 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.
Response
200 - application/json
Paginated list of bulk operations.
Was this page helpful?