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.

Skip to content
Paddle Docs home

Too many requests

There have been too many requests to the API from your IP address, so it's been temporarily rate-limited.

Example response
{
"error": {
"type": "api_error",
"code": "too_many_requests",
"detail": "IP address exceeded the allowed rate limit. Retry after the number of seconds in the Retry-After header.",
"documentation_url": "https://developer.paddle.com/errors/shared/too_many_requests"
},
"meta": {
"request_id": "00000000-0000-0000-0000-000000000000"
}
}

Details

Status code
429
Error code
too_many_requests
Error message
IP address exceeded the allowed rate limit. Retry after the number of seconds in the Retry-After header.

Common causes

  • You've sent too many requests to the API from your IP address and hit a rate limit. Rate limiting helps protect the Paddle platform and make sure it works smoothly for everyone.
  • A third-party integration you authorized may be contributing to your rate limit.

Troubleshooting

  • Check the Retry-After header included with the error response. This is the number of seconds that your account is limited for. Retry your request after the number of seconds.
  • Minimize the number of requests by using include parameters or temporarily caching data for a short period — especially when building client-side applications.
  • Contact the Paddle Seller Support team if you're not sure why you're being rate limited, or you're expecting a spike in traffic. Include the request_id with your message, if you received one.

Was this page helpful?