Documentation

Malformed request parameter

A path, query, header, or cookie parameter could not be decoded into its transport type, or its encoding was malformed.

Last reviewed October 27, 2026

Problem identity

HTTP status: 400. Stable code: malformed_parameter.

Type URI: https://openapi-to-rust.dev/problems/malformed-parameter.

How to respond

Use the errors array to find the parameter. Check percent encoding and the expected scalar type, such as an integer or boolean.

Example response

The response uses application/problem+json. This is an illustrative body; individual violations depend on the request.

Response body json
{
  "type": "https://openapi-to-rust.dev/problems/malformed-parameter",
  "title": "Malformed request parameter",
  "status": 400,
  "code": "malformed_parameter",
  "errors": [
    {
      "code": "malformed",
      "location": "/query/limit",
      "message": "is malformed"
    }
  ]
}

Error fields

type identifies the problem category, title summarizes it, status mirrors the HTTP status, and code is a stable machine-readable label. The optional errors array contains sanitized code, location, and message fields. Empty arrays are omitted.

Locations are JSON Pointers rooted at /body, /path, /query, /header, or /cookie. Violations are deduplicated, capped (16 by default), then sorted. Messages omit submitted values and internal diagnostics.

Clients can use the type URI as an identifier without fetching this page for every error. See RFC 9457, section 3.1.1.

Related documentation