Error reference
A list of all the errors that you can encounter when working with the Paddle API. Learn more about a particular error and get information about how to troubleshoot.
How errors work
The Paddle API uses standard HTTP response codes to let you know when something's wrong. It also returns some useful information to help you troubleshoot.
When you encounter an error, the API returns an error object
rather than a data object or array. Validation errors include an errors array with details of each invalid field.
If you're having trouble, include the request_id in the response when contacting support.
{ "error": { "type": "request_error", "code": "not_found", "detail": "Product pro_01ghbk4xjn4qdsmstcwzgcgg35 not found.", "documentation_url": "https://developer.paddle.com/errors/shared/not_found" }, "meta": { "request_id": "00000000-0000-0000-0000-000000000000" }}{ "error": { "type": "request_error", "code": "invalid_field", "detail": "Request does not pass validation.", "documentation_url": "https://developer.paddle.com/errors/shared/invalid_field", "errors": [ { "field": "active", "message": "must be provided as part of the request" }, { "field": "description", "message": "maximum length of 256 exceeded. provided value length 653" } ] }, "meta": { "request_id": "00000000-0000-0000-0000-000000000000" }}Addresses
Encountered when working with address entities.
Adjustments
Encountered when creating or working with transaction adjustments.
Businesses
Encountered when working with business entities on a customer.
Currencies
Encountered when working with currencies or currency-related settings.
Customers
Encountered when working with customer entities.
Discounts
Encountered when working with discount entities.
Notifications
Encountered when working with notification and webhook entities.
Payment methods
Encountered when working with saved payment method entities.
Prices
Encountered when working with price entities.
Products
Encountered when working with product entities.
Reports
Encountered when working with report entities.
Generic
General errors that can occur across the API.
Subscriptions
Encountered when working with subscription entities.
Transactions
Encountered when working with transaction entities.