Error Codes and Messages

Amazon E-Commerce Service (ECS) errors provide you with information about syntactical errors in your requests, as well as errors that occur during the execution of your request (for example, a search for products returns no results). Errors are composed of two elements: code and message. The error code is a unique string that identifies the error; the error message is a human-readable description of the error that serves as an aid in debugging. These elements will be nested within an Error element. If a request generates more than one error, all Errors will appear in the response.

Errors may appear at different levels in your response. Their location reflects at what stage in the execution of the request the error was generated and what kind of error it is. Errors in syntax that prevent requests from being executed will appear as children of the response's root element. An error associated with a particular item in the response will be a child of the Item element. See the sample requests for examples of each of these situations.

For a more detailed description of error handling, consult the Handling Error Codes chapter in the Programming Guide.

ECS returns error messages in English for the Amazon.com (US), Amazon.co.uk (UK), and Amazon.de (DE) locales. Error messages are in Japanese for the Amazon.co.jp (JP) locale.

Error Code & Description Message Affected Operations

AWS.ExactParameterRequirement

You will receive this message when the value of your parameter is longer than permitted by ECS.

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

AWS.ExceededMaximumParameterValues

You will receive this error message when you specify too many values for one or more parameters in your request (i.e., 11 transaction IDs for the TransactionId parameter in TransactionLookup, instead of ten or fewer).

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

AWS.InsufficientParameterValues

You will receive this error message when your request contains an insufficient 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

You will receive this error if ECS is unable to complete your request due to an internal problem or outage. 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.InvalidEnumeratedParameter

You will receive this error message when your request contains an invalid value for a parameter that has an explicit list of valid values, such as DeliveryMethod or SearchIndex.

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

AWS.InvalidISO8601Time

You will receive this error when your request contains a date or time value that is not formatted according to the profile of the ISO-8601 date/time standard that is described at http://www.w3.org/TR/NOTE-datetime. For example, this error will be returned if your request contains an invalid value for the Version parameter.

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

AWS.InvalidOperationForMarketplace

You will receive this error message when you try to execute an operation in a locale where the operation is not supported.

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

AWS.InvalidOperationParameter

You will receive this error message when the operation name you entered is not available from ECS. For instance, if you tried to use AsinSearch (from AWS 3.0) as an operation name, you would get this error since AsinSearch is not a valid operation name in ECS 4.0.

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

AWS.InvalidParameterCombination

You will receive this error message when two or more of the request parameters you have entered can not be used in the same request. For example, if you are using the CartAdd operation, you would receive this error if you tried to add items to the cart by both ASIN and OfferListingId.

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

AWS.InvalidParameterValue

You will receive this error message when your request contains an invalid value for an ID parameter, such as ItemId or SellerId.

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

AWS.InvalidResponseGroup

You will receive this error message when the response group name you entered in your request is incompatible with the operation you would like to perform.

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

AWS.InvalidServiceParameter

You will receive this error message when the service name you provide in your request is not recognized or supported by Amazon. All ECS 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

You will receive this error message when the subscription ID you use in your request is not recognized by AWS.

Your request contains an invalid subscription ID. Please retry your request with a valid subscription ID. All

AWS.InvalidXSLTAddress

You will receive this error if the AWS XSLT service is unable to access the XSLT file you used as the value for the Style parameter in your request

We are unable to access your XSLT file. Please verify that you have specified a valid address to your XSLT file. All

AWS.MaximumParameterRequirement

You receive this error message when your request contains the wrong number of parameters from an exclusive group.

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

AWS.MinimumParameterRequirement

You receive this error message when your request contains the wrong number of parameters from an exclusive group.

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

AWS.MissingOperationParameter

You will receive this error message when your request does not include the Operation parameter and the name of the operation you would like to perform.

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

You will receive this error message when your request does not contain a combination of two or more parameters that must be present together in your request.

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

AWS.MissingParameters

You will receive this error when your request does not include all of the parameters required by the operation.

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

AWS.MissingParameterValueCombination

You will receive this error message when your request requires a combination of parameters, one or more of which must have a specific value. For example, when you make an ItemLookup request for a product based on its Universal Product Code (or UPC), you are required to include the IdType and ItemId parameters. The value of the IdType parameter must be UPC.

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

AWS.MissingServiceParameter

You will receive this error message when the your request does not contain the required 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

You will receive this error message when you submit a parameter value that exceeds or is lower than the range of valid values for the parameter. For example, ItemSearch allows you to fetch search results page using the ItemPage parameter. The range of values for ItemPage is 1 to 500. If you supply a value outside that range (less than 1 or greater than 500), you will receive this error.

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

AWS.ParameterRepeatedInRequest

You receive this error message when you include the same parameter more than once in your request.

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

AWS.RestrictedParameterValueCombination

You will receive this error message when your request contains a combination of parameter values that are not permitted in the same request. For example, if you are using the ListSearch operation and have selected BabyRegistry as the ListType, you may not use the Name parameter.

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

AWS.XSLTTransformationError

You will receive this error message when the AWS XSLT service is unable to parse or apply the XSLT stylesheet you have provided in the Style parameter in your request. Make sure that your XSLT stylesheet is valid, and try again.

We were unable to apply your XSLT file. Please check your XSLT and retry your request. All

AWS.ECommerceService.ExceededMaximumCartItems

You will receive this error message when you exceed the maximum quantity value allowed for items being added to a shopping cart.

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

AWS.ECommerceService.InvalidCartId

You will receive this error message when the CartId you entered into your request is not recognized.

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

AWS.ECommerceService.InvalidHMAC

You will receive this error message when the shopping cart HMAC value you use in your request is not recognized by ECS. The HMAC value is a unique token that is used to associate a cart with an Amazon user and a particular session on the Amazon web site.

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.

AWS.ECommerceService.InvalidQuantity

You will receive this error message when the quantity in your request is not valid for the current item.

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

AWS.ECommerceService.ItemAlreadyInCart

You will receive this error message when you try to add an item to a shopping cart that already contains that item.

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

AWS.ECommerceService.ItemNotAccessible

Some products cannot be manipulated or viewed using ECS. You will receive this error message when the product ID you use in your request is not available through ECS.

This item is not accessible through ECS.

AWS.ECommerceService.ItemNotEligibleForCart

Some products cannot be manipulated or viewed using ECS. You will receive this error message when you attempt to add such an item to a remote shopping cart.

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.

AWS.ECommerceService.NoExactMatches

You will receive this error message when no products, restaurants, lists, or customers matching your search request can be found.

We did not find any matches for your request.

AWS.ECommerceService.NoSimilarities

You will receive this error message when there are no products or restaurants similar to the item(s) you specify in your request.

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