Skip to main content
apiguide.dev

HTTP 431 — Request Header Fields Too Large

The server refuses to process the request because header fields are too large.

Status CodeHTTP 431
CategoryClient Error (4xx)
API Error Subtypes0 error schemas
HTTP Headers0 headers

What does HTTP status code 431 mean?

The 431 Request Header Fields Too Large status code indicates that the server rejects the request because the headers (or a single header field) are too large.

When to use it in APIs

Usually triggered when a client sends extremely large cookies, authorization tokens (like bloated JWTs), or request parameters.

How it compares to other codes

  • 400 Bad Request: A generic request failure. 431 explicitly points to header size violations.

Specific API Error Types for 431

No specific Problem+JSON schemas have been defined for HTTP 431 on apiguide.dev yet.

Associated HTTP Headers

No specific HTTP headers are explicitly linked to HTTP 431 in our directory yet.

Related HTTP Status Codes