ebaysoldlistingsDOCS

Errors

Every error code the eBay Sold Listings API returns, what it means, and whether to retry. Errors are never billed.

Errors return an HTTP status and a JSON body with a stable code and a readable message. Only successful requests are billed: every error response, including 5xx, is free.

{ "error": "Too many requests, slow down.", "code": "rate_limited" }
StatuscodeMeaningRetry?
400invalid_paramsA parameter is missing or invalid; the message says whichNo, fix the request
401unauthorizedMissing or invalid API keyNo
402quota_exceededMonthly allowance used up, or too small for the batchNo, upgrade or wait for the reset
402payment_requiredThe last subscription payment failed, so the account is on hold. Never chargedNo, update the payment method in Billing. Access resumes automatically once paid
404not_foundBatch job id does not exist for this accountNo
404not_foundeBay has no page for this search: the page is past the last page of results, or the categoryId does not exist on that marketplace. Never chargedNo, stop paging or fix the category
409conflictA batch job is already running, or not finished yetAfter the job finishes
429rate_limitedPer-minute limit hitYes, after Retry-After
502upstream_blockedeBay temporarily refused this searchYes, shortly
502upstream_errorCould not reach the data sourceYes, shortly
503server_busyThe data source is busyYes, after Retry-After
504upstream_timeoutThe search took too longYes
Same keyword failing again and again.

If one keyword keeps returning upstream_blocked while others work, eBay is refusing that exact search. Try it with fewer words or a different word order, and contact support if it persists.