---
title: "Create or update customer verification (KYC)"
method: PUT
path: "/verifications/{uuid}"
tags: ["Verifications"]
---

# Create or update customer verification (KYC)

`PUT /verifications/{uuid}`

Submits KYC information for a customer. Supported types are `INDIVIDUAL`, `SELFEMPLOYEE`, and `LEGAL`.
For `LEGAL` type, representative information is required.

## Path parameters

- `uuid` string, required

## Request body

- VerificationInput
  - `type` 'NATURAL' | 'SOLETRADER' | 'LEGAL', required — Verification type. `NATURAL` for individuals, `SOLETRADER` for self-employed, `LEGAL` for companies.
  - `first_name` string, required
  - `last_name` string, required
  - `vat_id` string, required — Tax identification number (DNI, NIF, CIF, etc.).
  - `legal_address` string, required
  - `legal_city` string, required
  - `legal_zip` string, required
  - `legal_state` string, required
  - `legal_country` string — ISO 3166-1 alpha-2 country code.
  - `legal_name` string — Company legal name. Required for `LEGAL` type.
  - `birthday` string, date, nullable
  - `occupation` string, nullable
  - `income_range` number, nullable
  - `representative_name` string — Required for `LEGAL` type.
  - `representative_email` string, email — Required for `LEGAL` type.
  - `representative_phone` string — Required for `LEGAL` type.

## Response `200`

Verification submitted

- Verification
  - `id` integer
  - `self` string
  - `uuid` string
  - `type` 'INDIVIDUAL' | 'SELFEMPLOYEE' | 'LEGAL'
  - `status` 'CREATED' | 'PENDING' | 'VALIDATED' | 'REFUSED'
  - `refused_reason` string, nullable
  - `connections` Connections — Hypermedia links to related resources.

## Other responses

- `422` — Validation error

## Changes

- **2026-03-11** `ff825f6602c8` — 2 breaking, 2 info
  - removed the enum value `INDIVIDUAL` of the request property `type`
  - removed the enum value `SELFEMPLOYEE` of the request property `type`
  - added the new `NATURAL` enum value to the request property `type`
  - added the new `SOLETRADER` enum value to the request property `type`

[Change history](https://skmtc.dev/truust-io/apis/truust-api/changes/verifications/:uuid/put.md)

---

[API](https://skmtc.dev/truust-io/apis/truust-api.md) · [All operations](https://skmtc.dev/truust-io/apis/truust-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/truust-io/truust-api/revisions/cc81e28726b9/schema)