putListingsItem

put https://sellingpartnerapi-na.amazon.com/listings/2021-08-01/items/{sellerId}/{sku}

Creates or fully updates an existing listings item for a selling partner.

Note: This operation has a throttling rate of one request per second when mode is VALIDATION_PREVIEW.

Note: The parameters associated with this operation may contain special characters that must be encoded to successfully call the API. To avoid errors with SKUs when encoding URLs, refer to URL Encoding.

Usage Plan:

Rate (requests per second)	Burst
5	10

The x-amzn-RateLimit-Limit response header returns the usage plan rate limits that were applied to the requested operation, when available. The table above indicates the default rate and burst values for this operation. Selling partners whose business demands require higher throughput may see higher rate and burst values than those shown here. For more information, see Usage Plans and Rate Limits in the Selling Partner API.

Path Params

sellerId

string

required

A selling partner identifier, such as a merchant account or vendor code.

sku

string

required

A selling partner provided identifier for an Amazon listing.

Query Params

marketplaceIds

array of strings

required

length ≤ 1

A comma-delimited list of Amazon marketplace identifiers for the request.

marketplaceIds*

includedData

array of strings

Defaults to issues

A comma-delimited list of data sets to include in the response. Default: issues.

Show Details

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.

includedData

mode

string

The mode of operation for the request.

issueLocale

string

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.

200

Successfully understood the request to create or fully-update a listings item. See the response to determine if the submission has been accepted.

Response body

object

sku

string

required

A selling partner provided identifier for an Amazon listing.

status

string

required

The status of the listings item submission.

ACCEPTED INVALID VALID

Show Details

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`.

submissionId

string

required

The unique identifier of the listings item submission.

issues

array of objects

Listings item issues related to the listings item submission.

issues

object

code

string

required

An issue code that identifies the type of issue.

message

string

required

A message that describes the issue.

severity

string

required

The severity of the issue.

ERROR WARNING INFO

Show Details

ERROR	Indicates an issue has occurred preventing the submission from processing, such as a validation error.
WARNING	Indicates an issue has occurred that should be reviewed, but has not prevented the submission from processing.
INFO	Indicates additional information has been provided that should be reviewed.

attributeNames

array of strings

The names of the attributes associated with the issue, if applicable.

attributeNames

categories

array of strings

required

List of issue categories.

Possible vales:

INVALID_ATTRIBUTE - Indicating an invalid attribute in the listing.
MISSING_ATTRIBUTE - Highlighting a missing attribute in the listing.
INVALID_IMAGE - Signifying an invalid image in the listing.
MISSING_IMAGE - Noting the absence of an image in the listing.
INVALID_PRICE - Pertaining to issues with the listing's price-related attributes.
MISSING_PRICE - Pointing out the absence of a price attribute in the listing.
DUPLICATE - Identifying listings with potential duplicate problems, such as this ASIN potentially being a duplicate of another ASIN.
QUALIFICATION_REQUIRED - Indicating that the listing requires qualification-related approval.

categories*

enforcements

object

This field provides information about the enforcement actions taken by Amazon that affect the publishing or status of a listing. It also includes details about any associated exemptions.

identifiers

array of objects

Identity attributes associated with the item in the Amazon catalog, such as the ASIN.

identifiers

object

marketplaceId

string

A marketplace identifier. Identifies the Amazon marketplace for the listings item.

asin

string

Amazon Standard Identification Number (ASIN) of the listings item.

Headers

object

x-amzn-RateLimit-Limit

string

Your rate limit (requests per second) for this operation.

x-amzn-RequestId

string

Unique request reference identifier.

400

Request has missing or invalid parameters and cannot be parsed.

403

Indicates that access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.

413

The request size exceeded the maximum accepted size.

415

The request payload is in an unsupported format.

429

The frequency of requests was greater than allowed.

500

An unexpected condition occurred that prevented the server from fulfilling the request.

503

Temporary overloading or maintenance of the server.

xxxxxxxxxx
curl --request PUT \
     --url 'https://sellingpartnerapi-na.amazon.com/listings/2021-08-01/items/sellerId/sku?includedData=issues' \
     --header 'accept: application/json' \
     --header 'content-type: application/json'

LISTING	Indicates the submitted data contains product facts and sales terms.
LISTING_PRODUCT_ONLY	Indicates the submitted data contains product facts only.
LISTING_OFFER_ONLY	Indicates the submitted data contains sales terms only. Not supported for vendors (vendors will receive an HTTP status code 400 response).

200Successfully understood the request to create or fully-update a listings item. See the response to determine if the submission has been accepted.

400Request has missing or invalid parameters and cannot be parsed.

403Indicates that access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.

413The request size exceeded the maximum accepted size.

415The request payload is in an unsupported format.

429The frequency of requests was greater than allowed.

500An unexpected condition occurred that prevented the server from fulfilling the request.

503Temporary overloading or maintenance of the server.