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/individual/{customer_id}>

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

Field Type Required Description
employment_status String Yes Employment status (employed, self_employed, unemployed, retired, student)
most_recent_occupation_code String Yes Occupation code/description
expected_monthly_payments_usd String Yes Expected transaction volume (LessThan5K, 5KTo50K, MoreThan50K)
source_of_funds String Yes Source of funds (Salary, Business, Investment, etc.)
account_purpose String Yes Account purpose (personal_use, business, other)
account_purpose_other String Conditional Required if account_purpose is "other"
acting_as_intermediary Boolean Yes Whether acting on behalf of another party