Skip to content
SumUp Developer

Validation Failed

Understand the SumUp API Validation Failed response, common causes, and example payload for requests that do not pass validation.

Indicates that the request payload fails validation rules.

Common Causes

Section titled “Common Causes”
  • An ID or reference does not match the expected format.
  • A field violates length or pattern constraints.
  • A required nested field is missing in the payload.
{
    "type": "https://developer.sumup.com/problem/validation-failed",
    "title": "Bad Request",
    "status": 400,
    "detail": "Validation failed",
    "instance": "9b8eda265e35"
    "failed_constraints": [
        {
            "reference": "checkoutId",
            "message": "Invalid checkout ID: 'not_a_valid_id'"
        }
    ]
}