---
title: "Validate data against a schema"
method: POST
path: "/json-forms/validate-data"
tags: ["JSON Forms"]
---

# Validate data against a schema

`POST /json-forms/validate-data`

## Request

- Base URL: `https://example.itential.io`
- URL: `https://example.itential.io/json-forms/validate-data`
- Auth: none declared

Performs data validation, given a JSON schema and form data.

## Request body

- object
  - `jsonSchema` union
    - boolean
    - JsonFormsMetaSchema1
      - `$id` string, uri-reference
      - `$schema` string, uri
      - `$ref` string, uri-reference
      - `$comment` string
      - `title` string
      - `description` string
      - `default` unknown
      - `readOnly` boolean
      - `examples` unknown[]
        - unknown
      - `multipleOf` number, double
      - `maximum` number, double
      - `exclusiveMaximum` number, double
      - `minimum` number, double
      - `exclusiveMinimum` number, double
      - `maxLength` integer
      - `minLength` integer
      - `pattern` string, regex
      - `additionalItems` unknown
      - `items` union
        - unknown
        - unknown[]
          - unknown
      - `maxItems` integer
      - `minItems` integer
      - `uniqueItems` boolean
      - `contains` unknown
      - `maxProperties` integer
      - `minProperties` integer
      - `required` string[]
      - `additionalProperties` unknown
      - `definitions` object
      - `properties` object
      - `patternProperties` object
      - `dependencies` object
      - `propertyNames` unknown
      - `const` unknown
      - `enum` unknown[]
        - unknown
      - `type` union
        - 'array' | 'boolean' | 'integer' | 'null' | 'number' | 'object' | 'string'
        - JsonFormsMetaSchemaOneOf1TypeOneOf1Items[]
      - `format` string
      - `contentMediaType` string
      - `contentEncoding` string
      - `if` unknown
      - `then` unknown
      - `else` unknown
      - `allOf` unknown[]
        - unknown
      - `anyOf` unknown[]
        - unknown
      - `oneOf` unknown[]
        - unknown
      - `not` unknown
  - `data` JsonFormsFormDocumentFormData

## Response `200`

results from the form validation

- JsonFormsFormDocumentValidationResponse
  - `status` '200' | '404'
  - `validation` JsonFormsFormDocumentValidationResponseValidation
    - `valid` boolean
    - `errors` string[]
  - `message` string

## Other responses

- `500`: Error response from API

## Changes

- **2026-10-31** `2095cc90e583`: 2 info
  - api tag `JSON Forms` added
  - api tag `jsonForms` removed

[Operation history](https://skmtc.dev/itential/apis/itential-2/changes/json-forms/validate-data/post.md)

---

[API](https://skmtc.dev/itential/apis/itential-2.md) - [All operations](https://skmtc.dev/itential/apis/itential-2/llms.txt) - [OpenAPI document](https://skmtc.dev/itential/apis/itential-2/revisions/2095cc90e583?raw)