Skip to main content
POST
Batch Add Scan Task

Supported Marketplaces

Use these 2-letter codes in the countries array (multi-marketplace request) or the X-Country-Code header (single marketplace).
CodeMarketplaceCodeMarketplace
AEUnited Arab EmiratesAUAustralia
ITItalyDEGermany
MXMexicoUKUnited Kingdom
INIndiaFRFrance
CACanadaSGSingapore
TRTurkeyJPJapan
NLNetherlandsSASaudi Arabia
ESSpainSESweden
BRBrazilUSUnited States
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: multi-marketplace batch request

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
barCodes
string[]
required
countries
enum<string>[] | null

Multi-marketplace request. Provide up to 4 marketplace country codes (maximum 4) to scan each barcode across several Amazon marketplaces in a single request. Token cost: a single-marketplace request uses 1 token; a multi-marketplace request (2-4 codes) uses 2 tokens. If omitted, the marketplace from the X-Country-Code header (default US) is used.

Maximum array length: 4
Available options:
AE,
IT,
MX,
IN,
CA,
TR,
NL,
ES,
BR,
AU,
DE,
UK,
FR,
SG,
JP,
SA,
SE,
US
callBackUrl
string | null

Response

200 - application/json

Status 200 OK

messages
string[] | null
succeeded
boolean
data
integer<int64>