Error Messages
Product Advertising API returns error messages in English for all marketplaces for now.
| Exception | Description | Message |
|---|---|---|
AccessDeniedException
|
This error occurs when the access key provided is not registered with Product Advertising API or the credentials being used are AWS credentials. | The Access Key is not enabled for accessing Product Advertising API. For information on registering for Product Advertising API, see Register for Product Advertising API. OR The Access Key [Access Key] is not enabled for accessing this version of Product Advertising API. Please migrate your credentials as referred here Managing your Existing AWS Security Credentials for the Product Advertising API. |
AssociateValidationException
|
This error occurs when access key is not mapped to primary of any approved associate store. | Your access key [Access Key] is not mapped to primary of approved associate store. Please visit associate central at [associate central link for requested marketplace] |
IncompleteSignatureException
|
This error occurs when all the components of signature are not provided with the request. | The request signature did not include all of the required components. If you are using an AWS SDK, requests are signed for you automatically; otherwise, go to the Signature Version 4 Signing Process Guide in the Sending a Request section. |
InvalidPartnerTagException
|
This error occurs when partner tag value is not present in request or is invalid. Valid Partner tag is store id or tracking id of your valid associate store in requested marketplace. | The partner tag is not mapped to a valid associate store with your access key [Access Key]. Please visit associates central at [associate central link for requested marketplace] |
InvalidSignatureException
|
This error occurs when some component of signature is not valid. Please check your credentials before trying again. | The request has not been correctly signed. If you are using an AWS SDK, requests are signed for you automatically; otherwise, go to Signing a Request Guide. |
TooManyRequestsException
|
If the requests at which Product Advertising API 5.0 is being hit is too high, it will result in this exception. | The request was denied due to request throttling. Please verify the number of requests made per second to the Amazon Product Advertising API. |
RequestExpiredException
|
Each request is signed with a signature. The signed requests are valid for 15 minutes. After that, the requests expire and new signature are supposed to be generated before requesting again. | The request is past expiry date or the request date (either with 15 minute padding), or the request date occurs more than 15 minutes in the future. |
ValidationException
|
This error arises when any of the input parameter relating to request is invalid or is missing. | Varies, depending upon the specific error(s) encountered. |
UnknownOperationException
|
If the operation requested is not valid, this exception arises. | The operation requested is invalid. Please verify that the operation name is typed correctly. |
UnrecognizedClientException
|
If any client is not authorized to request Product Advertising API, this error arises. | The Access Key or security token included in the request is invalid. |
It is also possible to submit a valid request and still have error. In such cases, the HTTP Status Code is 200 Success, however, the response might contain errors. For more information, refer Processing of Errors.
Sample Error Scenarios
Invalid Operation
HTTP/1.1 400 Bad Request
{
"__type": "com.amazon.paapi#UnknownOperationException",
"Errors": [
{
"Code": "UnknownOperation",
"Message": "The operation requested is invalid. Please verify that the operation name is typed correctly."
}
]
}
Invalid Marketplace
However, Marketplace parameter is not mandatory as Product Advertising API deduces target Amazon marketplace from the host header. Even though, if an invalid marketplace value (like www.amazon123.com) is provided, then Product Advertising API throws following error:
HTTP/1.1 400 Bad Request
{
"__type": "com.amazon.paapi#ValidationException",
"Errors": [
{
"Code": "InvalidParameterValue",
"Message": "The value www.amazon123.com provided in the request for Marketplace is invalid."
}
]
}
Invalid Associate
If PartnerType is Associate, it's mandatory that access key is mapped to associate account which has atleast one store of which customer is Primary and store is in approved status.
HTTP/1.1 403 Forbidden
{
"__type": "com.amazon.paapi#AssociateValidationException",
"Errors": [
{
"Code": "InvalidAssociate",
"Message": "Your access key [Access Key] is not mapped to Primary of approved associate store. Please visit associate central at [associate central link for requested marketplace]"
}
]
}
Missing PartnerTag
PartnerTag parameter is mandatory to get a successful response from PAAPI.
HTTP/1.1 400 Bad Request
{
"__type": "com.amazon.paapi#ValidationException",
"Errors": [
{
"Code": "MissingParameter",
"Message": "PartnerTag should be provided."
}
]
}
Empty/Null PartnerTag
HTTP/1.1 400 Bad Request
{
"__type": "com.amazon.paapi#ValidationException",
"Errors": [
{
"Code": "InvalidParameterValue",
"Message": "The value provided in the request for PartnerTag is invalid."
}
]
}
In-correct PartnerTag
HTTP/1.1 400 Bad Request
{
"__type": "com.amazon.paapi#InvalidPartnerTagException",
"Errors": [
{
"Code": "InvalidPartnerTag",
"Message": "The partner tag is not mapped to a valid associate store with your access key <YourAccessKey>. Please visit associates central at <associate central link for requested marketplace>"
}
]
}
Missing PartnerType
PartnerType parameter is mandatory to get a successful response from PAAPI.
HTTP/1.1 400 Bad Request
{
"__type": "com.amazon.paapi#ValidationException",
"Errors": [
{
"Code": "MissingParameter",
"Message": "PartnerType should be provided."
}
]
}
Invalid PartnerType
HTTP/1.1 400 Bad Request
{
"__type": "com.amazon.paapi#ValidationException",
"Errors": [
{
"Code": "InvalidParameterValue",
"Message": "The value DummyPartnerType provided in the request for PartnerType is invalid."
}
]
}