4xx Client error

414 URI Too Long

The URL is longer than the server will process.

What 414 means

Usually caused by huge query strings. Servers commonly cap URLs at around 8 KB.

Common causes

Too many or too long query parameters.
A redirect loop appending to the URL.

How to fix it

If you're calling an API

Send the data in a POST body instead of the query string.

If you run the server

Accept POST for search endpoints with large filters.

Should you retry?

Not with the same URL.

Example response

HTTP

HTTP/1.1 414 URI Too Long
Content-Type: application/problem+json

{
  "type": "about:blank",
  "title": "URI Too Long",
  "status": 414,
  "detail": "The URL is longer than the server will process."
}

Defined in: RFC 9110 (HTTP Semantics). 414 is a client error: change the request before retrying.

Debugging an API call? Convert your request with the cURL converter, check the response with the JSON formatter, or see whether the API is down on its status page.

HTTP 414 FAQ

What does HTTP 414 mean?

414 URI Too Long: The URL is longer than the server will process. Usually caused by huge query strings. Servers commonly cap URLs at around 8 KB.

Is 414 a client or server error?

It's a client error (4xx): something about the request needs to change before it can succeed.

How do I fix a 414 error?

Send the data in a POST body instead of the query string.

Should I retry after a 414?

Not with the same URL.

Other 4xx status codes

All HTTP status codes