Skip to content

bad_request

Property Value
Error Code bad_request
HTTP Status 400 Bad Request
Title Bad request

Description

The request body is malformed, unreadable, or cannot be deserialized. This typically indicates a structural issue with the JSON payload rather than a field-level validation error.

Example Response

{
  "type": "https://docs.payalo.com/errors/bad_request",
  "title": "Bad request",
  "status": 400,
  "detail": "Invalid format of the request.",
  "errorCode": "bad_request"
}

Common Causes

  • Invalid JSON syntax (missing commas, unclosed braces, etc.)
  • Incorrect Content-Type header (must be application/json)
  • Empty request body
  • Unexpected data types (e.g., string where a number is expected)

Resolution

  • Validate your JSON payload before sending.
  • Ensure the Content-Type: application/json header is present.
  • Verify that field types match the expected schema.

Note: This error is not retryable. Fix the request payload before resubmitting.