Error codes

Errors use { "success": false, "error": { "code", "message", "details?" } }. Branch on the frozen code, not on the human-readable message.

HTTP	Code	Meaning	Do this
400	INVALID_REQUEST	Request validation failed	Correct the named fields and do not retry unchanged
400	UNSUPPORTED_API_VERSION	The override names an unknown or retired version	Choose a version from the returned supported set
401	UNAUTHORIZED	The Seller Marketplace API key is missing or invalid	Re-copy the complete key or replace a revoked key
404	ORDER_NOT_FOUND	No Order exists for this Seller-scoped key and id	Confirm the Order id and the Seller credential
409	SELLER_SOURCE_EXCLUSIVE	The Seller’s Inventory source is not platform	Stop retrying because partner push writes are unavailable for this Seller
413	BATCH_TOO_LARGE	A Listing write exceeds 1,000 items	Split the batch before retrying
422	INVALID_TRANSITION	The requested Order lifecycle move is illegal	Read the Order and branch on its current state
429	RATE_LIMITED	The per-Seller item ceiling was exceeded	Wait for the Retry-After duration

Operation pages list their complete expected errors and corrective actions. Use this appendix when the code is known but the operation is not.

Need help?

Email Marketplace support with this page and the sandbox environment prefilled.

Never include an API key or Signing secret in the message.