{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-developer-resources/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Validation Error","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"validation-error","__idx":0},"children":["Validation Error"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Field"},"children":["Field"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Value"},"children":["Value"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Type URI"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://docs.ingrid.com/developer-resources/ingrid-api/errors/common/validation-error"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Title"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Validation Error"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Recommended Status"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["400 Bad Request"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"common-causes","__idx":1},"children":["Common Causes"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["One or more required fields are missing from the request body"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A field value does not match the expected format or constraints"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A field value is outside the allowed range"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"error-details","__idx":2},"children":["Error Details"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Unlike other error types, the Validation Error includes an ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["errors"]}," array with detailed information about each field that failed validation. Each entry contains:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["code"]}]}," — A stable, machine-readable error code (e.g., ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["error.email.required"]},")"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["message"]}]}," — A human-readable description of the failure"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["param"]}]}," — The specific field or JSON path that caused the error (e.g., ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["email"]},")"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"example-response","__idx":3},"children":["Example Response"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"type\": \"https://docs.ingrid.com/developer-resources/ingrid-api/errors/common/validation-error\",\n  \"title\": \"Validation Error\",\n  \"status\": 400,\n  \"detail\": \"One or more fields failed validation.\",\n  \"instance\": \"urn:ingrid:request:9b056bec-432e-43ea-afbf-c2b886aeaa47\",\n  \"errors\": [\n    {\n      \"code\": \"error.email.required\",\n      \"message\": \"Email is required\",\n      \"param\": \"email\"\n    }\n  ]\n}\n","lang":"json"},"children":[]}]},"headings":[{"value":"Validation Error","id":"validation-error","depth":1},{"value":"Common Causes","id":"common-causes","depth":2},{"value":"Error Details","id":"error-details","depth":2},{"value":"Example Response","id":"example-response","depth":2}],"frontmatter":{"title":"Validation Error","description":"One or More Fields Failed Validation","seo":{"title":"Validation Error"}},"lastModified":"2026-02-24T19:14:57.408Z","pagePropGetterError":{"message":"","name":""}},"slug":"/developer-resources/ingrid-api/errors/common/validation-error","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}