Patch listings item

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

patch/api/v1/sp-api/listings/2021-08-01/items/{sku}

Request

Base URL: https://app.sellerassistant.app (the document declares no server; this is the origin it was published from)
URL: https://app.sellerassistant.app/api/v1/sp-api/listings/2021-08-01/items/{sku}
Auth: one of:
- API key in query parameter api_key
- API key in header X-Api-Key

Path parameters

The seller SKU of the item

Query parameters

A comma-delimited list of data sets to include in the response. Default: issues. Allowed values: identifiers, issues. identifiers Identifiers associated with the item in the Amazon catalog, such as Amazon Standard Identification Number (ASIN). Can only be requested when mode is VALIDATION_PREVIEW. issues The issues associated with the listing item.

Enables validation-only mode without creating/updating listings. Use VALIDATION_PREVIEW to check for errors before actual submission. When enabled, the system validates the request payload and returns validation results without making any changes to your listings.

A locale for localization of issues. When not provided, the default language code of the first marketplace is used. Examples: en_US, fr_CA, fr_FR. Localized messages default to en_US when a localization is not available in the specified locale.

Amazon marketplace domain. Domain amazon.com is used by default if domain and marketplaceId are not provided. If both domain and marketplaceId are chosen, domain has bigger priority. Options: amazon.com, amazon.ca, amazon.co.uk, amazon.de, amazon.es, amazon.it, amazon.fr, amazon.in, amazon.com.mx, amazon.com.br.

Amazon marketplace id. Domain amazon.com is used by default if domain and marketplaceId are not provided. If both domain and marketplaceId are chosen, domain has bigger priority. See all options here.

Request body

productTypestring required

The Amazon product type of the listings item.

Example request

{
  "productType": "TREE_TOPPER",
  "patches": [
    {
      "op": "replace",
      "path": "/attributes/purchasable_offer",
      "value": [
        {
          "currency": "USD",
          "audience": "ALL",
          "our_price": [
            {
              "schedule": [
                {
                  "value_with_tax": 50.45
                }
              ]
            }
          ],
          "marketplace_id": "ATVPDKIKX0DER"
        }
      ]
    }
  ]
}

Response

Successful response

skustring

A selling partner provided identifier for an Amazon listing.

status'ACCEPTED' | 'INVALID' | 'VALID'

The status of the listings item submission. ACCEPTED: The listings submission was accepted for processing. INVALID: The listings submission was not valid and was not accepted for processing. VALID: The listings submission was valid. Only returned when the mode is VALIDATION_PREVIEW.

submissionIdstring

The unique identifier of the listings item submission

Example response

{
  "sku": "Test Catan 07-11-2025 B00U26V4VQ",
  "status": "INVALID",
  "submissionId": "f1dc2914-75dd-11ea-bc55-0242ac130003",
  "issues": [
    {
      "code": "90220",
      "message": "'size' is required but not supplied.",
      "severity": "ERROR",
      "attributeNames": [
        "size"
      ],
      "identifiers": [
        {
          "marketplaceId": "ATVPDKIKX0DER",
          "asin": "B00U26V4VQ"
        }
      ]
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.