Amazon SP API

Authorization

Tested

POST

{{auth_url}}/auth/o2/token

Authorization

Last modified:2025-04-16 12:08:58

Maintainer:Sarath S

Generates access and refresh tokens to use with the Amazon SP API.

Request

Body Params application/json

grant_type

string

required

The type of grant being used, e.g., 'refresh_token'.

refresh_token

string

required

The refresh token issued by Amazon SP API.

client_id

string

required

The client ID associated with your SP API application.

client_secret

string

required

The client secret for your SP API application.

Example

{
  "grant_type": "refresh_token",
  "refresh_token": "{{refresh_token}}",
  "client_id": "{{client_id}}",
  "client_secret": "{{client_secret}}",
  "scope":"sellingpartnerapi::reports"
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location -g --request POST 'https://api.amazon.com/auth/o2/token' \
--header 'Content-Type: application/json' \
--data-raw '{
  "grant_type": "refresh_token",
  "refresh_token": "",
  "client_id": "amzn1.application-oa2-client.533f4c6416a8474f93bff7ee7252bb76",
  "client_secret": "amzn1.oa2-cs.v1.9a12388c25ce08847f03f7346becb92976707f5ab2a7ec981b3af5ccd28b82cb",
  "scope":"sellingpartnerapi::reports"
}'

Responses

🟢200Success

application/json

Successfully generated access token.

Body

access_token

string

required

The access token for API requests.

refresh_token

string

required

The refresh token for obtaining new access tokens.

token_type

string

required

The type of token issued, e.g., 'bearer'.

expires_in

integer

required

Time in seconds until the access token expires.

Examples

SuccessError

{
    "access_token": "Atza|IwEBIMGQoe2HHUETvR2qDQwr62XFGz70wpApgpsPKDjAbh_xLM4GY3Ge-clLM0zDLa9usdXD2CgsWQasFzRis9dnGHMgE0XQA56UiNJ_jonpSxPo0oAookUYbkWKt43M8LNF-HggV09yRYURLlewyB93KcCsmw7xaqqE_5NN3aGLWXwlghl-7twRLxlodGrAvJVlcdJDVQYeCSVJiqIgVMl49b5K3evtuSPxc2a_ue4i1sZvXNByz89AGvLHnX_MspkXFUMIWLJcbVxNAHbfw6vk3wru8GH4joyO9oKvm3yoUc4529AYLatvzWqhWGn4ARC0qqjlrSPlryyqSPpphUMHug0e",
    "refresh_token": "Atzr|IwEBINWWe9asFu6sqP84GMQzNq7dAKbCH_RrL5Sl-5XY1nhMVRbvGX3x_c6xWjAWAzOMkaimM5xV6uhJY2LMesd7Vw-8ekLlf8RQzMqTjYqZos1ASROOQ8MD40nyoXopbmV8J2NjdqkATIHfE3CHjXY4etpWbvvGXmiO2tJGAKaoUfcCiYng-e3zJvJS6ZCjwDntaK6q7KuquvkEICzGFhKHMp1f4r1Cftg-WAZkMAt39lHytmlAlKrWFK1EYSKkfu6_njNUOFqUq7QxKDNKhfsEP07HkcNQ0cn8RO6WnjIy7ApxSH33JD_AE9ckt-aSXXgEJPg",
    "token_type": "bearer",
    "expires_in": 3600
}

🟠400Bad Request

listInventory

Catalog Items