> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fnskutoasin.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 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).

| Code | Marketplace          | Code | Marketplace    |
| ---- | -------------------- | ---- | -------------- |
| AE   | United Arab Emirates | AU   | Australia      |
| IT   | Italy                | DE   | Germany        |
| MX   | Mexico               | UK   | United Kingdom |
| IN   | India                | FR   | France         |
| CA   | Canada               | SG   | Singapore      |
| TR   | Turkey               | JP   | Japan          |
| NL   | Netherlands          | SA   | Saudi Arabia   |
| ES   | Spain                | SE   | Sweden         |
| BR   | Brazil               | US   | United States  |

<Info>
  **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.**
</Info>

<Note>
  **Token cost:** a single-marketplace request (one code, or none) consumes **1 token**. A multi-marketplace request (2–4 codes) consumes **2 tokens**.
</Note>

<Note>
  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**.
</Note>

### Example: multi-marketplace batch request

```json theme={null}
{
  "barCodes": ["X0012ABCDE", "X0034FGHIJ"],
  "countries": ["US", "CA", "UK", "AE"],
  "callBackUrl": "https://your-app.example.com/webhook"
}
```


## OpenAPI

````yaml post /v1/ScanTask/Batch
openapi: 3.0.0
info:
  title: ATO.BARCODE
  description: '<h4>Baseurl: <strong>https://ato.fnskutoasin.com</strong></h4>'
  version: 1.0.0
servers:
  - url: https://ato.fnskutoasin.com/api
security: []
paths:
  /v1/ScanTask/Batch:
    post:
      tags:
        - ScanTask
      summary: Batch Add Scan Task
      operationId: ScanTask_Batch
      parameters:
        - name: X-Country-Code
          in: header
          description: >-
            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.
          required: false
          schema:
            type: string
            default: US
      requestBody:
        x-name: command
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BatchAddScanTasksCommand'
        required: true
        x-position: 1
      responses:
        '200':
          description: Status 200 OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResultOfLong'
      security:
        - ApiKey: []
components:
  schemas:
    BatchAddScanTasksCommand:
      type: object
      additionalProperties: false
      required:
        - barCodes
      properties:
        barCodes:
          type: array
          items:
            type: string
        countries:
          type: array
          description: >-
            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.
          maxItems: 4
          nullable: true
          items:
            type: string
            enum:
              - AE
              - IT
              - MX
              - IN
              - CA
              - TR
              - NL
              - ES
              - BR
              - AU
              - DE
              - UK
              - FR
              - SG
              - JP
              - SA
              - SE
              - US
        callBackUrl:
          type: string
          nullable: true
    ResultOfLong:
      allOf:
        - $ref: '#/components/schemas/Result'
        - type: object
          additionalProperties: false
          properties:
            data:
              type: integer
              format: int64
    Result:
      type: object
      additionalProperties: false
      properties:
        messages:
          type: array
          nullable: true
          items:
            type: string
        succeeded:
          type: boolean
  securitySchemes:
    ApiKey:
      type: apiKey
      in: header
      name: Api-Key

````