Menu
Product Advertising API
Developer Guide (API Version 2013-08-01)

Error Messages

Product Advertising API returns error messages in English for the Amazon.com (US), Amazon.co.uk (UK), Amazon.de (DE), Amazon.fr (FR), and Amazon.ca (CA) locales.

Error messages are in Japanese for the Amazon.co.jp (JP) locale.

Error Code & DescriptionMessageAffected Operations

AWS.ExactParameterRequirement

This error indicates the length of your parameter is longer than allowed by the Product Advertising API.

Your request contains too much data for [ParameterName]. This parameter can have a maximum length of [MaximumNumber].All

AWS.ExceededMaximumParameterValues

This error indicates the request has too many values for one or more parameters.

Your request contains too many values for [ParameterName]. This parameter can have a maximum of [MaximumNumber] values.

ItemLookup

SimilarityLookup

AWS.InsufficientParameterValues

This error indicates your request does not have the minimum number of values for a required parameter.

Your request contains too few values for [Parameter Name]. This parameter must have a minimum of [Minimum Value] values.All

AWS.InternalError

This error indicates an internal problem or outage is preventing Product Advertising API from completing your request.

For SOAP, this will be presented as a SOAP fault rather than an error.

We are unable to process your request at this time. Please retry your request. If you encounter this error repeatedly, please post a message on the AWS discussion board.All

AWS.InvalidAccount

This error indicates the request has an AWS access key ID in a locale where it is not registered for the Product Advertising API.

Your AccessKey Id is not registered for Product Advertising API. Please use the AccessKey Id obtained after registering at [RegistrationUrlForThatLocale] All

AWS.InvalidAssociate

This error indicates your account is not registered for Amazon Associates. If you see this error, verify:

  • You registered as an Amazon Associate in the requested locale. For more information, see Becoming an Associate.

  • You correctly added your Associate ID (tag) to your requests.

  • You added the email address registered for the Product Advertising API as a primary or secondary email address in your Amazon Associates account.

Your [AccessKeyId] is not registered as an Amazon Associate. Please register as an associate at [AssociateRegistrationUrlForThatLocale].All

AWS.InvalidEnumeratedParameter

This error indicates your request has an invalid value for a parameter.

For example, SearchIndex has an explicit list of valid values.

The value you specified for [ParameterName] is invalid. Valid values include [EnumeratedValuesList]. CartAdd

CartCreate

CartModify

ItemLookup

ItemSearch

SimilarityLookup

AWS.InvalidISO8601Time

This error indicates your request has a date or time value that is not formatted according to the ISO 8601 standard.

For example, this error is returned if your request has an invalid value for the Version parameter.

See Date and Time Formats.

[ParameterName]has an invalid value. It must contain a valid ISO 8601 date and time.All

AWS.InvalidOperationForMarketplace

This error indicates a request has an operation that is not supported for the locale.

This operation, [OperationName], is not available for this locale.All

AWS.InvalidOperationParameter

This error indicates you chose an invalid operation.

For example, if your request has the AsinSearch operation, you will receive an error because AsinSearch is no longer supported.

The Operation parameter is invalid. Please modify the Operation parameter and retry. Valid values for the Operation parameter include [ListOfOperationValues].All

AWS.InvalidParameterCombination

This error indicates two or more of the request parameters cannot be in the same request.

For example, if the CartAdd operation includes an ASIN and OfferListingId, you will receive an error.

Your request contains an invalid parameter combination. [ParameterName] and [ParameterName] cannot appear in the same request.

ItemSearch

CartCreate

CartAdd

AWS.InvalidParameterValue

This error indicates your request has an invalid value for an ID parameter, such as ItemId.

[ParameterValue] is not a valid value for [ParameterName]. Please change this value and retry your request.

CartAdd

CartCreate

CartModify

ItemLookup

ItemSearch

SimilarityLookup

AWS.InvalidResponseGroup

This error indicates you chose a response group that cannot be used with the operation.

Your ResponseGroup parameter is invalid. Valid response groups for [Operation Name] requests include [Available Response Group List].All

AWS.InvalidServiceParameter

This error indicates the service name is not recognized or supported. All Product Advertising API requests should use the service name AWSECommerceService.

The Service parameter is invalid. Please modify the Service parameter and retry. Valid values for the Service parameter include [ValidServicesList].All

AWS.InvalidSubscriptionId

This error indicates the subscription ID in your request is not recognized.
Your request contains an invalid subscription ID. Please retry your request with a valid subscription ID.All

AWS.MaximumParameterRequirement

This error indicates your request exceeds the maximum number of allowed parameters.

Your request should have at most [Maximum Number] of the following parameters: [Parameter Names].All

AWS.MinimumParameterRequirement

This error indicates your request does not have the minimum number of required parameters.

Your request should have at least [Minimum Number] of the following parameters: [Parameter Names].All

AWS.MissingOperationParameter

This error indicates your request does not include the Operation parameter and/or the operation name.

Your request is missing the Operation parameter. Please add the Operation parameter to your request and retry. Valid values for the Operation parameter include [ValidOperationsList].All

AWS.MissingParameterCombination

This error indicates your request does not have a combination of two or more required parameters.

Your request is missing a required parameter combination. Required parameter combinations include [Parameter One].ItemLookup

AWS.MissingParameters

This error indicates your request does not have the required parameters for the operation.

Your request is missing required parameters. Required parameters include [RequiredParameterList].All

AWS.MissingParameterValueCombination

This error indicates your request has a combination of parameters, and one or more parameters must have a specific value.

For example, an ItemLookup request for a Universal Product Code (UPC) must include the IdType and ItemId parameters. The value of IdType must be UPC.

Your request is missing a required parameter combination. When [Parameter One] equals [Restricted Value], [Parameter Two] must be present.ItemLookup

AWS.MissingServiceParameter

This error indicates your request does not have the Service parameter.

Your request is missing the Service parameter. Please add the Service parameter to your request and retry. Valid values for the Service parameter include [ValidServicesList].All

AWS.ParameterOutOfRange

This error indicates you submitted a parameter value that is not within the range of valid values.

For example, ItemSearch allows you to fetch search results per page with the ItemPage parameter. The range of values for ItemPage is 1 to 10. If the value you chose is less than 1 or greater than 10, an error is returned.

The value you specified for [ParameterName] is invalid. Valid values must be between [LowerBound] and [UpperBound].ItemSearch

ItemLookup

AWS.ParameterRepeatedInRequest

This error indicates your request has a duplicate parameter.

The parameter, [ParameterName], appeared more than once in your request.All

AWS.RestrictedParameterValueCombination

This error indicates your request has a combination of parameter values that are not permitted in the same request.

Your request contains a restricted parameter combination. When [Parameter One] equals [Restricted Value], [Parameter Two] cannot be present.All

AWS.ECommerceService.ExceededMaximumCartItems

This error indicates you cannot add more items to a shopping cart.

You may not add more than [Maximum Item Quantity] items to the cart.

CartAdd

CartCreate

AWS.ECommerceService.InvalidCartId

This error indicates the Product Advertising API does not recognize the CartId.

Your request contains an invalid value for CartId. Please check your CartId and retry your request.

CartAdd

CartClear

CartGet

CartModify

AWS.ECommerceService.InvalidHMAC

This error indicates the Product Advertising API does not recognize the shopping cart HMAC value in the request.

The HMAC value is a unique token that associates a shopping cart with an Amazon customer, and a specific session on the Amazon marketplace.

Your request contains an invalid value for HMAC. Please check your HMAC and retry your request. Remember that the HMAC must be URL-encoded if you are using REST.

CartAdd

CartClear

CartGet

CartModify

AWS.ECommerceService.InvalidQuantity

This error indicates the quantity in your request is not valid for the item.

You have exceeded the maximum quantity allowed for the following item(s): [ItemId].

CartAdd

CartCreate

CartModify

AWS.ECommerceService.ItemAlreadyInCart

This error indicates the shopping cart already has the item you are trying to add.

The item you specified, [ItemID], is already in your cart.

CartAdd

CartCreate

AWS.ECommerceService.ItemNotAccessible

This error indicates the item is not available through the Product Advertising API.

This item is not accessible through Product Advertising API. ItemLookup

AWS.ECommerceService.ItemNotEligibleForCart

This error indicates the item cannot be added to the shopping cart through the Product Advertising API.

The item you specified, [ItemID], is not eligible to be added to the cart. Check the item's availability to make sure it is available.

CartAdd

CartCreate

CartModify

AWS.ECommerceService.NoExactMatches

This error indicates the item could not be found.

We did not find any matches for your request.ItemSearch

AWS.ECommerceService.NoSimilarities

This error indicates similar items could not be found.

There are no similar items for this ASIN(s): [ItemID].SimilarityLookup

RequestThrottled

This error indicates your application is submitting requests faster than allowed by the IP or account.

For more information about rates, see Efficiency Guidelines.

Request from [ID | IP] is throttled.

All