HTTP 406 Not Acceptable

What is HTTP 406 Not Acceptable?

The 406 (Not Acceptable) status code indicates that the target resource does not have a current representation that would be acceptable to the user agent, based on the proactive negotiation header fields received in the request (such as Accept, Accept-Language, or Accept-Encoding).

Common Use Cases

• Requesting an unsupported content type via Accept header
• Language negotiation failure

// Laravel - content negotiation with 406
if ($request->prefers('xml') && ! $request->expectsJson()) {
    return response()->json([
        'error' => 'XML not supported',
        'supported_types' => ['application/json'],
    ], 406);
}