---
title: "Verify account"
method: POST
path: "/accounts/verify"
tags: ["Account"]
---

# Verify account

`POST /accounts/verify`

Submits KYC (Know Your Customer) information for the authenticated account.
Use `NATURAL` for individuals and `LEGAL` for companies.
For `LEGAL` type, representative information is required.

## Request body

- object
  - `type` 'NATURAL' | 'SOLETRADER' | 'LEGAL', required — Verification type: `NATURAL` for individuals, `SOLETRADER` for self-employed, `LEGAL` for companies.
  - `first_name` string, required — First name of the account holder or representative.
  - `last_name` string, required — Last name of the account holder or representative.
  - `vat_id` string, required — Tax identification number (DNI, NIF, CIF, etc.).
  - `legal_name` string — Company legal name. Required for `LEGAL` type.
  - `legal_address` string, required — Legal registered address.
  - `legal_city` string, required
  - `legal_zip` string, required
  - `legal_state` string, required
  - `legal_country` string — ISO 3166-1 alpha-2 country code.
  - `birthday` string, date — Date of birth. Applicable for `NATURAL` type.
  - `occupation` string — Title or short description of occupation. Applicable for `NATURAL` type.
  - `income_range` number — Income range value. Applicable for `NATURAL` type.
  - `representative_name` string — Full name of the company representative. Required for `LEGAL` type.
  - `representative_email` string, email — Email of the company representative. Required for `LEGAL` type.
  - `representative_phone` string — Phone of the company representative. Required for `LEGAL` type.

## Response `200`

Account verification submitted

- Account
  - `self` string
  - `merchant_id` string — Unique merchant identifier (addon_key).
  - `name` string
  - `email` string, email
  - `currency` string
  - `country_code` string
  - `business_url` string, nullable
  - `business_phone` string, nullable
  - `business_description` string, nullable
  - `image_url` string, nullable
  - `public_key` string
  - `secret_key` string — Secret API key. Only visible to the account owner.
  - `allow_shipping` 0 | 1
  - `value_shipping` number
  - `is_active` boolean
  - `psd2_enabled` 0 | 1
  - `allowed_gateways` string[]
  - `gateways` object[], nullable — List of configured payment gateway objects for the account.
  - `default_gateway` string, nullable
  - `created_at` string, date-time, nullable

## 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/accounts/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)