← Error catalogue

400 Bad Request

The request was malformed.

Machine code: bad_request

Invalid JSON, a missing or invalid query parameter, or a body that failed shape validation.

How to resolve

Check the request body and query parameters against the API reference. The data member often lists the specific validation failures.

Response shape

Every error is an RFC 9457 application/problem+json document with a machine code and a trace_id you can quote to support.

{
  "type": "https://docs.openiris.io/errors/400",
  "title": "Bad Request",
  "status": 400,
  "code": "bad_request",
  "detail": "email must be a valid email address.",
  "instance": "/v1/users",
  "trace_id": "0HMVABCDEF123"
}