Skip to main content
POST
Batch Add Scan Task (per-barcode countries)
Submit many barcodes in one request, each with its own marketplaces.
Batch vs. BatchV2: Batch Add Scan Task applies its single countries list to every barcode in the request. Use BatchV2 when different barcodes should be scanned in different marketplaces.
Do not repeat a country code within a barcode’s countries (for example ["US", "US"] or ["US", "us"]). A request containing repeated codes is rejected and no tasks are created.

Supported Marketplaces

Use these 2-letter codes in the countries array (multi-marketplace request) or the X-Country-Code header (single marketplace).
Multi-marketplace requests: pass up to 4 country codes in the countries array to scan across several Amazon marketplaces in one request. Maximum 4 codes per request.
Token cost: a single-marketplace request (one code, or none) consumes 1 token. A multi-marketplace request (2–4 codes) consumes 2 tokens.
If you omit the countries array, the request uses the marketplace from the X-Country-Code header. When that header is not provided, it defaults to US.

Example: one marketplace per barcode

Example response

Authorizations

Api-Key
string
header
required

Headers

X-Country-Code
string
default:US

Optional 2-letter marketplace country code (e.g. US, UK, CA). Defaults to US if not provided. Used when the request body does not specify a 'countries' array. See the Supported Marketplaces list on this page.

Body

application/json
items
object[]
required

One entry per barcode. A barcode listed more than once is only processed once.

callBackUrl
string | null

Response

200 - application/json

Status 200 OK with the id of every newly created task

messages
string[] | null
succeeded
boolean
data
object[] | null