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.

