Errors by Number

This table lists all error and warning messages that could be encountered using the eBay Post-Order API.

All error messages are provided in English only. You can use the ID as an index into your own structure for supplying messages in whatever language or format you wish, but base your message translations on the error strings in this table.

Each error is either an Application Error, System Error or Request Error. This error type is indicated in error result sets by the value returned in the errorMessage.error.category return field. The error type indicates what sort of action the application, the developer, or the end-user needs to take in response to the error. Please refer to the Error Response documentation for details about the fields and values returned for error conditions.

Some of the errors use variables, where the returned entity or value varies based on the context. The variables in these error messages are represented with integer values, wrapped with curly brackets. The first/only variable in an error message will display as {0}, and the second variable in an error message will display as {1}. The actlual errors that are triggered when using the API will actually shown meaningful information/values.

Error Number	Severity	Description
1001	ERROR	Application encountered an internal error.
1301	ERROR	The user requesting for the case is neither the buyer nor seller of the item.
1302	ERROR	The user information is either missing or invalid.
1303	ERROR	Invalid item or transaction id. Ids of item or transaction should be positive number.
1304	ERROR	Invalid return id. No records found with requested returnId.
1305	ERROR	Invalid session ID
1306	ERROR	The user in the request is not the buyer of the item.
1308	ERROR	The user is not allowed to perform this operation.
1309	ERROR	Unsupported eligibility client type and check type combination.
1401	ERROR	The maximum number of records supported per page is {0}.
1402	ERROR	The minimum entries per page should be at least {0}.
1501	ERROR	Pre check failed.
1502	ERROR	Illegal State transition.
1503	ERROR	Return is not allowed to escalate.
1504	ERROR	Resolution svc failed to escalate.
1505	ERROR	Missing billing agreement.
1506	ERROR	User is not eligible for return center.
1507	ERROR	Address cannot be updated to the requested country.
1508	ERROR	Label should be initiated before invoking print label. Use initiateShippingLabel operation to initiate the label.
1601	ERROR	Missing Input.
1602	ERROR	Element {0} exceeded the max limit of {1}.
1603	ERROR	Refund option is not valid or applicable for this return.
1604	ERROR	Invalid order Id. Order Id should be a positive number.
1605	ERROR	Element {0} must be a positive number.
1606	ERROR	Invalid eligibility check type.
1607	ERROR	Invalid eligibility client type.
1608	ERROR	Duplicated Request.
1609	ERROR	Appeal already existed. User can not appeal more than once for a return.
1610	ERROR	REFUND_EXIST.
1611	ERROR	At order level, there is one existing successful (or pending) refund (or payout) activity.
1612	ERROR	There is one existing successful (or pending) money activity.
1613	ERROR	Invalid limit configuration. Please make sure the daily limit is less than or equal to the monthly limit and that the monthly limit is less than or equal to the yearly limit.
1614	ERROR	Invalid Tracking number, it does not exist in returns system.
1615	ERROR	Return already exists for this transaction.
1616	ERROR	Invalid Input.
1617	ERROR	The RMA input contains a special character that is not allowed. Please try again.
1618	ERROR	Invalid Input. PageNumber or EntriesPerPage is expected to be a number only.
1619	ERROR	This request cannot be declined.
1620	ERROR	Offer return option is not applicable in this scenario.
1621	ERROR	The requested carrier is invalid or is not eligible for this return.
1622	ERROR	Return cannot be approved without the label for this return.
1623	ERROR	You can only reply to messages from the seller here. To start a conversation, contact the seller.
1624	ERROR	Please add a message.
1625	ERROR	The ability to send messages isn't available.
1626	ERROR	Please enter a valid email address.
1627	ERROR	You've reached the maximum number of characters.
1628	ERROR	Document size criteria is not matched.
1629	ERROR	Document length criteria is not matched.
1630	ERROR	Document format is not supported.
1631	ERROR	Max. Number of documents reached.
1632	ERROR	Invalid Doc Owning Entity.
1633	ERROR	No Doc to submit.
1634	ERROR	Max Try reached.
1635	ERROR	More Documents to submit.
1636	ERROR	Invalid Doc Id.
1637	ERROR	Feature Off.
1700	ERROR	Label is eligible.
1701	ERROR	Label is ineligible because item is overweight.
1702	ERROR	Label is ineligible because label is too costly.
1703	ERROR	Label is ineligible because item is oversize.
1704	ERROR	Label is ineligible because buyer address is invalid.
1705	ERROR	Label is ineligible because seller address is invalid.
1706	ERROR	Label is ineligible because item's weight is unknown.
1707	ERROR	Label is ineligible because item's weight is zero.
1708	ERROR	Label is ineligible because item is oversize.
1709	ERROR	Label is ineligible because the user address is US territory address.
1710	ERROR	Label is ineligible for some unknown reason.
1711	ERROR	Label is ineligible because Buyer address is outside US.
1712	ERROR	The address information is either missing or invalid.
1746	ERROR	Auto-relist not eligible as the item has multi-quantity.
1747	ERROR	Auto-relist not eligible because of return reason.
1748	ERROR	Auto-relist not eligible as item already relisted.
1749	ERROR	Auto-relist not eligible as return is not delivered yet.
1750	ERROR	Auto-relist not enabled.
1751	ERROR	Auto-relist not eligible because item price is too low.
1752	ERROR	Auto-relist not eligible due to return policy.
1753	ERROR	Please add an instrument and try again manually.
1754	ERROR	Your refund did not go through. Please use a different payment option and try again.
1755	ERROR	Your refund did not go through. Please add a payment option to refund the buyer.
1764	ERROR	Your refund did not go through. Please try again later or contact us.
1768	ERROR	Label Execution Failed. Choose a different carrier or upload your own tracking.
1769	ERROR	Label Generation Failed. Retry to generate label.
1770	ERROR	Label Execution Failed, choose a different carrier.
1771	ERROR	RMA not applicable for linked account return.
10001	ERROR	Application encountered an internal error.
10002	ERROR	Illegal State transition.
10003	ERROR	Validation Error - Missing input.
10004	ERROR	Validation Error - Invalid input.
10005	ERROR	Eligibility Check failed.
10006	ERROR	Restricted to either seller or buyer.
292001	ERROR	Please supply a valid order ID to process your request.
292002	ERROR	Please supply a valid transaction ID to process your request.
292003	ERROR	Please supply a valid item ID to process your request.
292004	ERROR	The HTTP headers contained in the request appeared to be invalid. Please verify that the headers in your request are valid.
292005	ERROR	Please supply a valid desiredOutcome value (FULL_REFUND or STILL_WANT_ITEM) to process your request.
292006	ERROR	Please supply a valid message value to process your request.
292007	ERROR	No such order ID {0}. Please provide a valid order ID.
292008	ERROR	No such transaction ID {0}. Please provide a valid transaction ID.
292009	ERROR	No such item ID {0}. Please provide a valid item ID.
292010	ERROR	The application encountered an internal error. Contact support if this failure continues.
292012	ERROR	Unable to connect to service {0}. If this failure continues, please contact support.
292013	ERROR	The service framework was unable to identify a service to dispatch to or had some trouble in dispatching the request.
292014	ERROR	The service processed the request, but subsequent processing failed at the framework level.
292015	ERROR	Invalid site name {0}. Please provide a valid site name.
292016	ERROR	No such site ID {0}. Please provide a valid site ID.
292017	ERROR	Please supply a valid request ID to process your request.
292018	ERROR	The request is in an invalid start state for the operation.
292019	ERROR	Please supply a valid request ID to process your request.
292020	ERROR	Both item ID and transaction ID cannot be zero.
292021	ERROR	Could not find transaction with item ID {0} and transaction ID {1}.
292022	ERROR	A request already exists for the given transaction.
292023	ERROR	Please supply a valid tracking number.
292023	ERROR	Please provide a first name.
292024	ERROR	Please provide a street address.
292024	ERROR	Please supply a valid shipping carrier.
292025	ERROR	Please supply a valid shipping date.
292025	ERROR	Please provide a valid city.
292026	ERROR	Please provide a valid state or province.
292027	ERROR	Please provide a valid country code.
292028	ERROR	Please provide a last name.
292029	ERROR	Invalid country code {0}. Please provide a valid country code.
292030	ERROR	Please provide a valid ZIP code.
292031	ERROR	Invalid ZIP code {0}. Please provide a valid ZIP Code for country code {1}.
292032	ERROR	Invalid state or province {0} for country code {1}. Please provide a valid state or province.
292033	ERROR	Please provide a valid site name.
292034	ERROR	Please provide a valid return ID.
292035	ERROR	Please provide the return id, item id and transaction ID of a valid return item..
292036	ERROR	User {0} is removed from the program. Please provide a valid user ID.
292037	ERROR	Please provide a valid dispute type.
292038	ERROR	Invalid dispute type {0}. Please provide a valid dispute type.
292039	ERROR	Please provide a valid close reason to process your request.
292040	ERROR	Please provide a comment to process your request.
292041	ERROR	The user is not authorized to perform this operation.
292042	ERROR	Eligibility check failed for item ID {0} and transaction ID {1}. Please provide an eligible item ID and transaction ID.
292043	ERROR	Invalid reason {0}. Please provide a valid reason.
292044	ERROR	This operation doesn't support claims of type {0}.
292045	ERROR	This operation doesn't support non-escalated cases.
292046	ERROR	Please provide valid tracking information.
292047	ERROR	Eligibility checks to escalate the case have been failed.
292048	ERROR	Missing input.
292049	ERROR	Invalid input. Correct the attribute mentioned in parameter.
292050	ERROR	The tracking number cannot exceed {0} characters.
292051	ERROR	Refund failure due to insufficient funds awaiting payout. Please add a payment instrument and try again.
292052	ERROR	We were unable to charge your payment instrument. Please update your payment instrument and try again.
292053	ERROR	We couldn't process your refund. Please try again or contact us for help.
292054	ERROR	Your refund did not go through. Please use a different payment option and try again.
292055	ERROR	Your refund did not go through because we could not verify your payment option. Please change your payment option and try again.
292057	ERROR	You've exceeded the default payment method's limit. Please use a different payment option or try again later.
292058	ERROR	Charge balance is less than requested balance amount. Please try again later or contact us.
292060	ERROR	Your refund couldn't be processed. Please review the amount and try again.
292061	ERROR	We are having trouble verifying your credit card. Please ensure the billing address on your payment instrument matches the address on your card, or change your payment option below and try refunding again.
292062	ERROR	The country of the credit card issuer is different from the country of your registration account. Please select a different payment option and try refunding again or contact us for further assistance.
292063	ERROR	You have exceeded the number of credit cards for selling costs allowed on your account. Please select a different payment option and try refunding again or contact us for further assistance.
292064	ERROR	You have exceeded the number of credit cards for selling costs allowed on your account. Please select a different payment option and try refunding again or contact us for further assistance.
292065	ERROR	We are having trouble verifying your credit card. Please ensure all card details are up to date or select a different payment option and try refunding again.
292066	ERROR	The refund could not be completed because there is an issue with buyer's payment option. We will work with them to resolve it and no further action is required from you.
292067	ERROR	Your payment option does not have a sufficient balance for this refund. Please work with your payment provider or select a different option and try refunding again
292068	ERROR	We were unable to charge your payment instrument. Please update your payment instrument and try again.
292069	ERROR	Your refund could not go through. Please select a different payment option and try refunding again.