Troubleshoot SP-API Errors

Use these troubleshooting methods to identify and resolve Selling Partner API (SP-API) errors.

Prerequisites

To troubleshoot seller issues, you need the following logged information for each HTTP request:

Resource path
Status code
Error message
Seller ID
Marketplace ID

Step 1. Review the error response

Selling Partner API error messages help to identify error sources. To parse error responses, refer to Parse SP-API Responses: Error response.

If the error response provides details, use this information to correct the issue.
If details are insufficient, search for the error code, message, or HTTP status code in Resolve Common HTTP and Authorization Error Codes. This page covers common errors that apply to all APIs.

Step 2. Check API status

If the error persists, check for known API-specific issues:

API Health Dashboard: Access the API Health Dashboard to check the current status of an SP-API and determine whether any known issues exist.
API troubleshooting documentation: Check whether a troubleshooting or errors page exists for the API. If available, review it for known issues and resolutions.

Step 3. Identify error patterns

If the issue persists, compare logged errors across sellers to identify patterns:

Single seller affected: Indicates an account-specific issue. Contact the seller to verify their account configuration.
Multiple sellers affected: Indicates a system-wide issue. Continue to the next step.

Step 4. Determine the affected marketplace

It’s possible the call failed due to lack of regional support. Refer to the API reference documentation to confirm support for the API.

If the API is supported in the given marketplace, use the getMarketplaceParticipations operation to determine whether the seller’s account is correctly configured for that marketplace. API call failures can result from incorrect seller account information.

If any of these responses occur, verify the seller's account in this marketplace or request re-authorization:

The seller is not registered in the marketplace
The seller's account is suspended
The seller has not completed marketplace-specific requirements

Step 5. Contact support

If you’re unable to troubleshoot the issue, contact Selling Partner API Developer Support.