Skip to main content
POST
/
customers
/
{uuid}
/
verify
Create KYC for a customer
curl --request POST \
  --url https://api.truust.io/2.0/customers/{uuid}/verify \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "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"
}
'
{
  "id": 123,
  "self": "<string>",
  "uuid": "<string>",
  "type": "INDIVIDUAL",
  "status": "CREATED",
  "refused_reason": "<string>",
  "connections": {}
}

Authorizations

​
Authorization
string
header
required

Use your account's Secret Key as the Bearer token.

Path Parameters

​
uuid
string
required

Customer UUID.

Body

application/json
​
type
enum<string>
required

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

Available options:
NATURAL,
SOLETRADER,
LEGAL
​
first_name
string
required
Maximum string length: 255
​
last_name
string
required
Maximum string length: 255
​
vat_id
string
required

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

Maximum string length: 255
​
legal_address
string
required
Maximum string length: 255
​
legal_city
string
required
Maximum string length: 255
​
legal_zip
string
required
Maximum string length: 255
​
legal_state
string
required
Maximum string length: 255
​
legal_country
string

ISO 3166-1 alpha-2 country code.

Maximum string length: 2
​
legal_name
string

Company legal name. Required for LEGAL type.

Maximum string length: 255
​
birthday
string<date> | null
​
occupation
string | null
​
income_range
number | null
​
representative_name
string

Required for LEGAL type.

​
representative_email
string<email>

Required for LEGAL type.

​
representative_phone
string

Required for LEGAL type.

Response

KYC verification created

​
id
integer
​
self
string
​
uuid
string
​
type
enum<string>
Available options:
INDIVIDUAL,
SELFEMPLOYEE,
LEGAL
​
status
enum<string>
Available options:
CREATED,
PENDING,
VALIDATED,
REFUSED
​
refused_reason
string | null
​
connections
object

Hypermedia links to related resources.