HTTP 415 Unsupported Media Type

What is HTTP 415 Unsupported Media Type?

The 415 (Unsupported Media Type) status code indicates that the origin server is refusing to service the request because the payload is in a format not supported by the target resource. The client should check the Content-Type header it sent and ensure it matches one of the formats the server accepts.

Common Use Cases

• Uploading a file format the server does not accept
• API expecting JSON but receiving XML
• Invalid Content-Type header

// Laravel - validating Content-Type
if ($request->header('Content-Type') !== 'application/json') {
    return response()->json([
        'error' => 'Unsupported Media Type',
        'supported' => ['application/json'],
    ], 415);
}