v4

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

Verifications

Create or update customer verification (KYC)

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

put/verifications/{uuid}

Path parameters

uuidstring required

Verification 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

Verification submitted

idinteger

selfstring

uuidstring

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

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

refused_reasonstring nullable

connectionsConnections

Hypermedia links to related resources.