Troubleshoot Analytics Errors
Buy with Prime API is now available for early access
Sign up for early access to the Buy with Prime API using the 'Sign Up' button below. The API may change as Amazon receives feedback and iterates on it.
This topic describes errors that you can encounter when you Get Analytics Reports.
Errors starting report tasks
The following errors can occur when you call the startReportTask mutation.
| Error Type | Error Code | Description | Suggested Action |
|---|---|---|---|
AccessDeniedError | N/A | You don't have sufficient access to perform this action. | Ensure that your access token has permission to access this information, and retry the call. For details, see Authenticate to the Buy with Prime API. |
InternalServerError | N/A | Unexpected error during request processing. | None. This is a server-side error. |
ThrottlingError | N/A | You made too many requests to the API. You can have up to five startReportTask requests in STARTED or RUNNING state at any time. | Send the request again using exponential backoff. |
ValidationError | InvalidDateFormat | Invalid date format. | Provide a valid date range. Dates must be in ISO 8601 UTC format. |
ValidationError | InvalidDateRange | Invalid date range. | Provide a valid date range. |
ValidationError | InvalidReportType | The specified report type is not one of the allowed types. | Specify a report of an allowed type. For details, see Get Analytics Reports. |
Errors getting report status
The following errors can occur when you call the reportTask query.
| Error Type | Error Code | Description | Suggested Action |
|---|---|---|---|
AccessDeniedError | N/A | You don't have sufficient access to perform this action. | Ensure that your access token has permission to access this information, and retry the call. For details, see Authenticate to the Buy with Prime API. |
InternalServerError | N/A | Unexpected error during request processing. | None. This is a server-side error. |
ResourceNotFoundError | N/A | You queried an invalid or expired taskId. | Call startReportTask to create a new report. Reports expire seven days after creation. |
ThrottlingError | N/A | You made too many requests to the API. The maximum TPS is five. | Send the request again using exponential backoff. |
Errors getting a link to an analytics report
The following errors can occur when you call the reportDownloadLink query.
| Error Type | Error Code | Description | Suggested Action |
|---|---|---|---|
AccessDeniedError | N/A | You don't have sufficient access to perform this action. | Ensure that your access token has permission to access this information, and retry the call. For details, see Authenticate to the Buy with Prime API. |
InternalServerError | N/A | Unexpected error during request processing. | None. This is a server-side error. |
ResourceNotFoundError | N/A | You queried an invalid or expired taskId. | Call startReportTask to create a new report. Reports expire seven days after creation. |
ThrottlingError | N/A | You made too many requests to the API. The maximum TPS is five. | Send the request again using exponential backoff. |
Related topics
Updated 2 days ago