Skip to main content
​
type
string
invalid_request_error
​
status
number
400

​
What happened

One or more fields in your request did not pass validation. The details array tells you exactly which fields failed and why — fix them and retry. 
{
  "error": {
    "type": "invalid_request_error",
    "code": "VALIDATION_ERROR",
    "message": "Invalid request",
    "status": 400,
    "doc_url": "https://done.mintlify.app/errors/validation-error",
    "details": [
      {
        "path": "contract.price",
        "message": "Number must be greater than 0"
      }
    ]
  }
}

​
The details array

Each entry in details identifies one failing field:
FieldTypeDescription
pathstringDot-notation path to the field, e.g. contract.price. Array indices use bracket notation: conditions[0].event.
messagestringHuman-readable reason the field failed validation.

​
Common causes

contract.price must be a positive number greater than 0.
// ❌ invalid
{ "contract": { "price": 0 } }

// ✅ valid
{ "contract": { "price": 50 } }
The condition tree must use { "event": "..." } for leaf nodes and { "op": "AND"|"OR", "conditions": [...] } for operator nodes.
// ❌ invalid
{ "fulfillment_condition": { "type": "signed" } }

// ✅ valid leaf
{ "fulfillment_condition": { "event": "signed" } }

// ✅ valid AND node
{
  "fulfillment_condition": {
    "op": "AND",
    "conditions": [
      { "event": "signed_by_A" },
      { "event": "signed_by_B" }
    ]
  }
}
ID parameters like /:id must be a valid UUID v4.
// ❌ invalid
GET /v1/claims/abc123

// ✅ valid
GET /v1/claims/018e1b2c-3d4e-5f6a-7b8c-9d0e1f2a3b4c