Add Or Get Scan Task

curl --request POST \
  --url https://ato.fnskutoasin.com/api/v1/ScanTask/AddOrGet \
  --header 'Api-Key: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "barCode": "<string>",
  "countries": [],
  "callBackUrl": "<string>"
}
'

import requests

url = "https://ato.fnskutoasin.com/api/v1/ScanTask/AddOrGet"

payload = {
    "barCode": "<string>",
    "countries": [],
    "callBackUrl": "<string>"
}
headers = {
    "Api-Key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Api-Key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({barCode: '<string>', countries: [], callBackUrl: '<string>'})
};

fetch('https://ato.fnskutoasin.com/api/v1/ScanTask/AddOrGet', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://ato.fnskutoasin.com/api/v1/ScanTask/AddOrGet",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'barCode' => '<string>',
    'countries' => [
        
    ],
    'callBackUrl' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Api-Key: <api-key>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://ato.fnskutoasin.com/api/v1/ScanTask/AddOrGet"

	payload := strings.NewReader("{\n  \"barCode\": \"<string>\",\n  \"countries\": [],\n  \"callBackUrl\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Api-Key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://ato.fnskutoasin.com/api/v1/ScanTask/AddOrGet")
  .header("Api-Key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"barCode\": \"<string>\",\n  \"countries\": [],\n  \"callBackUrl\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://ato.fnskutoasin.com/api/v1/ScanTask/AddOrGet")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Api-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"barCode\": \"<string>\",\n  \"countries\": [],\n  \"callBackUrl\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "messages": [
    "<string>"
  ],
  "succeeded": true,
  "data": {
    "id": 123,
    "userId": "<string>",
    "user": "<string>",
    "asin": "<string>",
    "barCode": "<string>",
    "assignmentDate": "2023-11-07T05:31:56Z",
    "finishedOn": "2023-11-07T05:31:56Z",
    "createdOn": "2023-11-07T05:31:56Z",
    "duration": 123,
    "processingDuration": 123
  }
}

POST

ScanTask

AddOrGet

Add Or Get Scan Task

curl --request POST \
  --url https://ato.fnskutoasin.com/api/v1/ScanTask/AddOrGet \
  --header 'Api-Key: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "barCode": "<string>",
  "countries": [],
  "callBackUrl": "<string>"
}
'

import requests

url = "https://ato.fnskutoasin.com/api/v1/ScanTask/AddOrGet"

payload = {
    "barCode": "<string>",
    "countries": [],
    "callBackUrl": "<string>"
}
headers = {
    "Api-Key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Api-Key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({barCode: '<string>', countries: [], callBackUrl: '<string>'})
};

fetch('https://ato.fnskutoasin.com/api/v1/ScanTask/AddOrGet', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://ato.fnskutoasin.com/api/v1/ScanTask/AddOrGet",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'barCode' => '<string>',
    'countries' => [
        
    ],
    'callBackUrl' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Api-Key: <api-key>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://ato.fnskutoasin.com/api/v1/ScanTask/AddOrGet"

	payload := strings.NewReader("{\n  \"barCode\": \"<string>\",\n  \"countries\": [],\n  \"callBackUrl\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Api-Key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://ato.fnskutoasin.com/api/v1/ScanTask/AddOrGet")
  .header("Api-Key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"barCode\": \"<string>\",\n  \"countries\": [],\n  \"callBackUrl\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://ato.fnskutoasin.com/api/v1/ScanTask/AddOrGet")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Api-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"barCode\": \"<string>\",\n  \"countries\": [],\n  \"callBackUrl\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "messages": [
    "<string>"
  ],
  "succeeded": true,
  "data": {
    "id": 123,
    "userId": "<string>",
    "user": "<string>",
    "asin": "<string>",
    "barCode": "<string>",
    "assignmentDate": "2023-11-07T05:31:56Z",
    "finishedOn": "2023-11-07T05:31:56Z",
    "createdOn": "2023-11-07T05:31:56Z",
    "duration": 123,
    "processingDuration": 123
  }
}

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

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 request

{
  "barCode": "X0012ABCDE",
  "countries": ["US", "CA", "UK", "AE"],
  "callBackUrl": "https://your-app.example.com/webhook"
}

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

barCode

string

required

Minimum string length: 1

countries

enum<string>[] | null

Multi-marketplace request. Provide up to 4 marketplace country codes (maximum 4) to scan the 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

object | null

Show child attributes

Add Scan Task Batch Add Scan Task

​Supported Marketplaces

​Example: multi-marketplace request

Authorizations

Headers

Body

Response

Supported Marketplaces

Example: multi-marketplace request