---
title: "Validate metadata"
method: POST
path: "/v4/customers/validate-metadata"
tags: ["Customers"]
---

# Validate metadata

`POST /v4/customers/validate-metadata`

Validate metadata against merchant schema and return validation results.

## Request body

- ValidateMetadataV4RequestDto
  - `metadata` object, required — Metadata object to validate against merchant schema

## Response `200`

Validation results for the provided metadata.

- ValidateMetadataV4ResponseDto
  - `isValid` boolean, required — Whether the metadata is valid according to the schema
  - `validFields` object, required — Metadata fields that passed validation
  - `ignoredFields` array[], required — Fields that were ignored due to schema violations or unknown fields
    - unknown[]
      - unknown
  - `errors` array[], required — Validation error messages
    - unknown[]
      - unknown
  - `cleanedResult` object, required — The cleaned metadata that would be saved

## Other responses

- `400` — Returned when improperly formatted or missing fields in request body
- `401` — Returned when improper keys or headers are used in the request
- `403` — Returned when the caller is not authorized to access the resource
- `500` — Returned when an internal server error occurs

---

[API](https://skmtc.net/slopepay/apis/slope-v4-api.md) · [All operations](https://skmtc.net/slopepay/apis/slope-v4-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/slopepay/slope-v4-api/revisions/cbdbc861073b/schema)