Skip to main content
Submit KYC data for an individual customer. The customer must already exist in your account (created via POST /customer). After submission the status will be "submitted" and will move to "approved" once review is complete.
This endpoint is hosted on the KYC platform at https://kyc.yativo.com, not the main API base URL. Include an Idempotency-Key header on every request.

Identity fields

string
required
The customer UUID returned by POST /customer.
string
required
Customer’s first name. Max 1024 characters.
string
required
Customer’s last name. Max 1024 characters.
string
Customer’s middle name. Optional.
string
required
Customer’s email address.
string
required
Country dial code. Must match ^\+\d{1,4}$, e.g. "+1", "+44", "+234".
string
required
Phone number digits only, 8–15 characters. Do not include the country code.
string
required
Date of birth in YYYY-MM-DD format. Must be before today.
string
required
ISO 3166-1 alpha-2 country code, e.g. "US", "NG", "BR".
string
required
"male" or "female".
string
required
Tax identification number. Max 100 characters.
string
required
Selfie photo of the customer. Provide as a hosted URL (from POST /storage/upload) or a base64-encoded string. Accepted formats: PDF, JPG, JPEG, PNG, HEIC, TIF. Max 5 MB.
string
Bank Verification Number. Required when nationality is "NG". Exactly 11 digits.
string
National Identification Number. Required when nationality is "NG". Exactly 11 digits.

Residential address

object
required
Customer’s current residential address.

Identifying information

array
required
At least one government-issued ID document. Accepted document types depend on issuing_country — see the ID types reference.

Risk and purpose

string
required
Customer’s employment status. One of: "employed", "exempt", "homemaker", "retired", "self_employed", "student", "unemployed".
string
required
6-digit occupation code. Retrieve the full list from GET /auth/occupation-codes. Example: "151252" (Software developer).
string
required
Expected monthly transaction volume. One of: "0_4999", "5000_9999", "10000_49999", "50000_plus".
string
required
Primary source of funds. One of: "salary", "business_income", "company_funds", "savings", "investments_loans", "inheritance", "gifts", "government_benefits", "pension_retirement", "sale_of_assets_real_estate", "ecommerce_reseller", "gambling_proceeds", "someone_elses_funds".
string
required
Intended use of the account. One of: "receive_salary", "business_transactions", "purchase_goods_and_services", "personal_or_living_expenses", "payments_to_friends_or_family_abroad", "receive_payment_for_freelancing", "investment_purposes", "protect_wealth", "ecommerce_retail_payments", "operating_a_company", "charitable_donations", "other".
string
Required when account_purpose is "other". Provide a plain-text description.
boolean
Set to true if the customer is acting on behalf of third parties. Defaults to false.

Supporting documents

array
required
At least one supporting document is required.