v4

latestOpenAPI 3.1.0Proprietaryraw.githubusercontent.com2026-04-277127123.7 KB

Verifications

Create KYC for a customer

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.

post/customers/{uuid}/verify

Path parameters

uuidstring required

Customer UUID.

Request body

type'NATURAL' | 'SOLETRADER' | 'LEGAL' required

Verification type. NATURAL for individuals, SOLETRADER for self-employed, LEGAL for companies.

first_namestring required

last_namestring required

vat_idstring required

Tax identification number (DNI, NIF, CIF, etc.).

legal_addressstring required

legal_citystring required

legal_zipstring required

legal_statestring required

legal_countrystring

ISO 3166-1 alpha-2 country code.

legal_namestring

Company legal name. Required for LEGAL type.

birthdaystring date nullable

occupationstring nullable

income_rangenumber nullable

representative_namestring

Required for LEGAL type.

representative_emailstring email

Required for LEGAL type.

representative_phonestring

Required for LEGAL type.

Example request

{
  "type": "NATURAL",
  "first_name": "John",
  "last_name": "Doe",
  "vat_id": "12345678A",
  "legal_address": "Calle Mayor 1",
  "legal_city": "Madrid",
  "legal_zip": "28001",
  "legal_state": "Madrid",
  "legal_country": "ES"
}

Response

KYC verification created

idinteger

selfstring

uuidstring

type'INDIVIDUAL' | 'SELFEMPLOYEE' | 'LEGAL'

status'CREATED' | 'PENDING' | 'VALIDATED' | 'REFUSED'

refused_reasonstring nullable

connectionsConnections

Hypermedia links to related resources.