---
title: "Create KYC for a customer"
method: POST
path: "/customers/{uuid}/verify"
tags: ["Verifications"]
---

# Create KYC for a customer

`POST /customers/{uuid}/verify`

Submits KYC (Know Your Customer) identity verification information for a customer.
Supported types: `NATURAL`, `SOLETRADER`, `LEGAL`.
For `LEGAL` type, `legal_name`, `representative_name`, `representative_email` and `representative_phone` are 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`

KYC verification created

- 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` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/truust-io/apis/truust-api/changes/customers/:uuid/verify/post.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)