curl -X POST "https://api.scanova.io/bulk-operation/gs1/serial-range-generate/" \
-H "Authorization: 401f7ac837da42b97f613d789819ff93537bee6a" \
-H "Content-Type: application/json" \
-d '{
"name": "GS1 batch 001-100",
"start_serial": "00000001",
"count": 100,
"sample_qrid": "a1b2c3d4"
}'
{
"operation_id": "bo-gs1-001",
"message": ["Your GS1 serial range is being processed. We'll email you once it's ready."]
}
Bulk Operations
Bulk-generate a GS1 serial range
POST /bulk-operation/gs1/serial-range-generate/
POST
/
bulk-operation
/
gs1
/
serial-range-generate
/
curl -X POST "https://api.scanova.io/bulk-operation/gs1/serial-range-generate/" \
-H "Authorization: 401f7ac837da42b97f613d789819ff93537bee6a" \
-H "Content-Type: application/json" \
-d '{
"name": "GS1 batch 001-100",
"start_serial": "00000001",
"count": 100,
"sample_qrid": "a1b2c3d4"
}'
{
"operation_id": "bo-gs1-001",
"message": ["Your GS1 serial range is being processed. We'll email you once it's ready."]
}
Generates a contiguous range of GS1 QR Codes from a starting serial number, asynchronously, on the Management API host (
Same asynchronous pattern as Bulk-generate QR Codes — poll List bulk operations. The first assembled GS1 payload in the range is schema-validated before any QR Codes are created, so a malformed
api.scanova.io), authenticated with your raw Management API key.
POST https://api.scanova.io/bulk-operation/gs1/serial-range-generate/
Authorization: 401f7ac837da42b97f613d789819ff93537bee6a
No file upload — this endpoint generates the range programmatically from
start_serial and count.string
required
A label for this operation.
string
required
The first serial number in the range, digits only, max 20 characters.
integer
required
How many sequential serials to generate, minimum 1.
string
An existing GS1 QR’s id to copy shared field values from. Provide this or
shared_info, not neither.array
The GS1 field values shared by every serial in the range, as JSON. Provide this or
sample_qrid, not neither.integer
A custom domain id to use for the generated QR Codes’ short links.
string
Design pattern data applied to all generated QR Codes.
object
Optional auto-deactivation rule applied to all generated QR Codes.
object
UTM tracking parameters applied to all generated QR Codes’ links.
integer
A folder id to save the generated QR Codes into.
curl -X POST "https://api.scanova.io/bulk-operation/gs1/serial-range-generate/" \
-H "Authorization: 401f7ac837da42b97f613d789819ff93537bee6a" \
-H "Content-Type: application/json" \
-d '{
"name": "GS1 batch 001-100",
"start_serial": "00000001",
"count": 100,
"sample_qrid": "a1b2c3d4"
}'
{
"operation_id": "bo-gs1-001",
"message": ["Your GS1 serial range is being processed. We'll email you once it's ready."]
}
shared_info shape fails fast.
400 if the resulting serial exceeds 20 characters at any point in the range, if neither shared_info nor sample_qrid is provided, or if quota (BULK_OPERATION or TOTAL_QR_CODES, checked against the full count) is exceeded. 403 if the account lacks the BULK_OPERATION quota, has an inactive plan, or lacks BULK_OPERATION_CAN_GENERATE permission.
Related
- Bulk-generate QR Codes — the general file-upload-based equivalent for non-GS1 categories.
- List bulk operations — poll for completion.
- 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
Generation started.
Was this page helpful?