Skip to main content
POST
Create KYC for a customer

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
Maximum string length: 255
Maximum string length: 255
Maximum string length: 255
Maximum string length: 255

ISO 3166-1 alpha-2 country code.

Maximum string length: 2

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.