Overview
This documentation covers the API endpoints for submitting Know Your Customer (KYC) for individuals and Know Your Business (KYB) for business entities.
Individual KYC Endpoint
Endpoint
POST <https://kyc.yativo.com/api/individual-kyc/submit>
Description
Submit KYC information for an individual customer. This endpoint handles personal identification, address verification, and compliance documentation.
URL Parameters
| Parameter |
Type |
Required |
Description |
customer_id |
UUID |
Yes |
Unique identifier for the customer |
Request Body
Personal Information
| Field |
Type |
Required |
Description |
customer_id |
UUID |
Yes |
Customer unique identifier |
first_name |
String |
Yes |
Customer's first name |
middle_name |
String |
Yes |
Customer's middle name |
last_name |
String |
Yes |
Customer's last name |
email |
Email |
Yes |
Customer's email address |
phone |
String |
Yes |
Phone number with country code (e.g., +2349012345678) |
birth_date |
Date |
Yes |
Date of birth (YYYY-MM-DD) |
nationality |
String |
Yes |
Two-letter country code (ISO 3166-1 alpha-2) |
gender |
String |
Yes |
Gender (Male/Female/Other) |
taxId |
String |
Yes |
Tax identification number |
selfie_image |
String |
Yes |
Base64 encoded selfie image with prefix (data:image/png;base64,...) |
Residential Address
| Field |
Type |
Required |
Description |
residential_address.street_line_1 |
String |
Yes |
Primary street address |
residential_address.street_line_2 |
String |
No |
Additional address information |
residential_address.city |
String |
Yes |
City name |
residential_address.state |
String |
Yes |
State/Province |
residential_address.postal_code |
String |
Yes |
Postal/ZIP code |
residential_address.country |
String |
Yes |
Two-letter country code |
residential_address.proof_of_address_file |
String |
Yes |
Base64 encoded proof of address document |
Identifying Information
Array of identification documents. Each object contains:
| Field |
Type |
Required |
Description |
type |
String |
Yes |
Document type (passport, national_id, drivers_license) |
issuing_country |
String |
Yes |
Two-letter country code |
number |
String |
Yes |
Document number |
date_issued |
Date |
Yes |
Issue date (YYYY-MM-DD) |
expiration_date |
Date |
Yes |
Expiration date (YYYY-MM-DD) |
image_front_file |
String |
Yes |
Base64 encoded front image |
image_back_file |
String |
No |
Base64 encoded back image (if applicable) |
Financial Information