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

Request header fields too large

The request URI length or headers included in your request exceed the maximum allowed size.

Example response
{
"error": {
"type": "request_error",
"code": "request_headers_too_large",
"detail": "The provided request URI length or headers are too large.",
"documentation_url": "https://developer.paddle.com/errors/shared/request_headers_too_large"
},
"meta": {
"request_id": "00000000-0000-0000-0000-000000000000"
}
}

Details

Status code
431
Error code
request_headers_too_large
Error message
The provided request URI length or headers are too large.

Common causes

  • The request headers sent with your request exceed the maximum allowed size.
  • Too many query parameters have been provided, making the request URI too long.

Troubleshooting

  • Use one of the Paddle SDKs to make requests.
  • Set only the required headers in the request.
  • Reduce the number of query parameters in the request.

Was this page helpful?