TRtruust-io
Verifications

Create or update customer verification (KYC)

Changed on

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

put/verifications/{uuid}

Request

  • Base URL
    https://your-subdomain.truust.io/2.0
  • URL
    https://your-subdomain.truust.io/2.0/verifications/{uuid}
  • Auth
    HTTP bearer

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.

Changes

  • ff825f6602c8Revision changes
    • breaking

      removed the enum value INDIVIDUAL of the request property

    • breaking

      removed the enum value SELFEMPLOYEE of the request property

    • info

      added the new NATURAL enum value to the request property

    • info

      added the new SOLETRADER enum value to the request property