| [ Web Proxy ] |
| Viewing: https://developer.paddle.com/errors | [Back] [Original] |
For AI agents and LLMs: a structured documentation index is available at /llms.txt. Every page has a Markdown sibling append .md to any URL.
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.
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" }}General errors that can occur across the API.
Encountered when working with address entities.
Encountered when creating or working with transaction adjustments.
Encountered when working with business entities on a customer.
Encountered when working with checkout domain entities.
Encountered when working with currencies or currency-related settings.
Encountered when working with customer entities.
Encountered when working with discount entities.
Encountered when working with notification and webhook entities.
Encountered when working with saved payment method entities.
Encountered when working with price entities.
Encountered when working with product entities.
Encountered when working with report entities.
Encountered when working with subscription entities.
Encountered when working with transaction entities.
Paddle.com Market Ltd. 20122026
| Web Proxy Viewer | New URL | Original Page |