Put listings item - Seller Assistant API

Proxy to https://developer-docs.amazon.com/sp-api/reference/putlistingsitem. The limit is 60 requests per minute. Amazon seller account integration is required to make this request. You can do it here.

Request

Authorization

API Key

Add parameter in query

api_key

Example:

api_key: ********************

API Key

Add parameter in header

X-Api-Key

Example:

X-Api-Key: ********************

Path Params

Query Params

Body Params application/jsonRequired

Example

{
    "productType": "TREE_TOPPER",
    "attributes": {
        "merchant_suggested_asin": [
            {
                "value": "B08T8YZ48Y",
                "marketplace_id": "ATVPDKIKX0DER"
            }
        ],
        "condition_type": [
            {
                "value": "new_new",
                "marketplace_id": "ATVPDKIKX0DER"
            }
        ],
        "merchant_shipping_group": [
            {
                "value": "legacy-template-id",
                "marketplace_id": "ATVPDKIKX0DER"
            }
        ],
        "fulfillment_availability": [
            {
                "fulfillment_channel_code": "AMAZON_NA"
            }
        ],
        "purchasable_offer": [
            {
                "currency": "USD",
                "audience": "ALL",
                "our_price": [
                    {
                        "schedule": [
                            {
                                "value_with_tax": 28.33
                            }
                        ]
                    }
                ],
                "marketplace_id": "ATVPDKIKX0DER"
            }
        ],
        "batteries_required": [
            {
                "value": false,
                "marketplace_id": "ATVPDKIKX0DER"
            }
        ],
        "supplier_declared_dg_hz_regulation": [
            {
                "value": "not_applicable",
                "marketplace_id": "ATVPDKIKX0DER"
            }
        ],
        "max_order_quantity": [
            {
                "value": 3,
                "marketplace_id": "ATVPDKIKX0DER"
            }
        ]
    },
    "requirements": "LISTING_OFFER_ONLY"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request PUT 'https://app.sellerassistant.app/api/v1/sp-api/listings/2021-08-01/items/Test Companies 27-10-2025 B08T8YZ48Y?includedData=issues&mode=VALIDATION_PREVIEW&issueLocale=en_US&domain=amazon.com&marketplaceId=ATVPDKIKX0DER&api_key=<api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "productType": "TREE_TOPPER",
    "attributes": {
        "merchant_suggested_asin": [
            {
                "value": "B08T8YZ48Y",
                "marketplace_id": "ATVPDKIKX0DER"
            }
        ],
        "condition_type": [
            {
                "value": "new_new",
                "marketplace_id": "ATVPDKIKX0DER"
            }
        ],
        "merchant_shipping_group": [
            {
                "value": "legacy-template-id",
                "marketplace_id": "ATVPDKIKX0DER"
            }
        ],
        "fulfillment_availability": [
            {
                "fulfillment_channel_code": "AMAZON_NA"
            }
        ],
        "purchasable_offer": [
            {
                "currency": "USD",
                "audience": "ALL",
                "our_price": [
                    {
                        "schedule": [
                            {
                                "value_with_tax": 28.33
                            }
                        ]
                    }
                ],
                "marketplace_id": "ATVPDKIKX0DER"
            }
        ],
        "batteries_required": [
            {
                "value": false,
                "marketplace_id": "ATVPDKIKX0DER"
            }
        ],
        "supplier_declared_dg_hz_regulation": [
            {
                "value": "not_applicable",
                "marketplace_id": "ATVPDKIKX0DER"
            }
        ],
        "max_order_quantity": [
            {
                "value": 3,
                "marketplace_id": "ATVPDKIKX0DER"
            }
        ]
    },
    "requirements": "LISTING_OFFER_ONLY"
}'

Responses

🟢200OK

application/json

Successful response

Body

Example

{
    "sku": "Test Companies 27-10-2025 B08T8YZ48Y",
    "status": "ACCEPTED",
    "submissionId": "f1dc2914-75dd-11ea-bc55-0242ac130003",
    "issues": [
        {
            "code": "90220",
            "message": "'size' is required but not supplied.",
            "severity": "ERROR",
            "attributeNames": [
                "size"
            ],
            "categories": [
                "INVALID_ATTRIBUTE"
            ],
            "enforcements": {
                "actions": [
                    {
                        "action": "LISTING_SUPPRESSED"
                    }
                ],
                "exemption": {
                    "status": "EXEMPT",
                    "expiryDate": "2019-08-24T14:15:22Z"
                }
            },
            "identifiers": [
                {
                    "marketplaceId": "ATVPDKIKX0DER",
                    "asin": "B08T8YZ48Y"
                }
            ]
        }
    ]
}

🟠402Payment Required

🟠403Forbidden

🟠422Unprocessable Entity

🟠429Too Many Requests

🔴500Internal Server Error