Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.yativo.com/llms.txt

Use this file to discover all available pages before exploring further.

Submit KYC (Know Your Customer) data for an individual customer. The customer must already exist in your account. After submission, the status will be submitted and move to approved after review. 
POST https://kyc.yativo.com/api/individual-kyc/submit
This endpoint is on the KYC platform (https://kyc.yativo.com), not the main API base URL. Requires Idempotency-Key header.

​
Identity fields

​
customer_id
string
required
The customer UUID from POST /customer.
​
type
string
required
Must be "individual".
​
signed_agreement_id
string
Optional agreement UUID. If omitted, it is auto-generated by Yativo.
​
first_name
string
required
Customer’s first name.
​
last_name
string
required
Customer’s last name.
​
middle_name
string
Customer’s middle name (optional).
​
email
string
required
Customer’s email address.
​
phone
string
required
Phone number without country code.
​
calling_code
string
required
Country calling code, e.g. "+1", "+44", "+55".
​
gender
string
required
One of: "male", "female", "other".
​
birth_date
string
required
Date of birth in YYYY-MM-DD format.
​
nationality
string
required
ISO 3166-1 alpha-2 country code (e.g. "US", "BR", "GB").
​
taxId
string
required
Tax identification number for the customer.
​
selfie_image
string
required
URL or base64-encoded selfie image of the customer.

​
Residential address

​
residential_address
object
required

​
Identifying information

​
identifying_information
array
required
Minimum 1 government-issued ID document required.

​
Financial information

​
employment_status
string
required
One of: "Employed", "self_employed", "unemployed", "retired", "student".
​
most_recent_occupation_code
string
required
Occupation code from GET /auth/occupation-codes.
​
expected_monthly_payments_usd
string
required
"LessThan5K", "5KTo50K", or "MoreThan50K".
​
source_of_funds
string
required
Source of funds: "Salary", "Business", "Investment", "Savings", etc.
​
account_purpose
string
required
Purpose for the account, e.g. "ReceiveSalary".
​
account_purpose_other
string
Required when account_purpose is "other".
​
acting_as_intermediary
boolean
required
Whether the customer acts as an intermediary for third parties.

​
Virtual account preferences

​
usd_virtual_account
boolean
Request a USD virtual account.
​
eur_virtual_account
boolean
Request a EUR virtual account.
​
eurde_virtual_account
boolean
Request a EUR/DE virtual account. If true, usd_virtual_account and eur_virtual_account must be false.
​
gbp_virtual_account
boolean
Request a GBP virtual account.

​
Optional fields

​
uploaded_documents
array
Additional supporting documents.
​
sumsub_token
string
Optional Sumsub token for submissions that include liveness checks.
curl -X POST 'https://kyc.yativo.com/api/individual-kyc/submit' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: kyc-alex-smith-2026' \
  -d '{
    "customer_id": "c586066b-0f29-468f-b775-15483871a202",
    "type": "individual",
    "first_name": "Alex",
    "last_name": "Smith",
    "email": "alex.smith@example.com",
    "phone": "5551234567",
    "calling_code": "+1",
    "gender": "male",
    "nationality": "US",
    "birth_date": "1990-01-01",
    "taxId": "998877665",
    "selfie_image": "https://example.com/docs/selfie.jpg",
    "residential_address": {
      "street_line_1": "123 Main Street",
      "city": "Anytown",
      "state": "CA",
      "postal_code": "90210",
      "country": "US",
      "proof_of_address_file": "https://example.com/docs/proof.jpg"
    },
    "identifying_information": [
      {
        "type": "passport",
        "issuing_country": "US",
        "number": "P00012345",
        "date_issued": "2020-01-01",
        "expiration_date": "2030-01-01",
        "image_front_file": "https://example.com/docs/front.jpg"
      }
    ],
    "employment_status": "Employed",
    "most_recent_occupation_code": "132011",
    "expected_monthly_payments_usd": "LessThan5K",
    "source_of_funds": "Salary",
    "account_purpose": "ReceiveSalary",
    "acting_as_intermediary": false,
    "eur_virtual_account": false,
    "usd_virtual_account": true,
    "eurde_virtual_account": false,
    "gbp_virtual_account": false
  }'

{
  "success": true,
  "message": "KYC submission received successfully",
  "errors": {
    "submission": {
      "id": "sub_8f3b2a1c-4d5e-6f7a-8b9c-0d1e2f3a4b5c",
      "type": "individual",
      "status": "submitted",
      "customer_id": "c586066b-0f29-468f-b775-15483871a202",
      "first_name": "Alex",
      "last_name": "Smith",
      "email": "alex.smith@example.com",
      "endorsements": [
        {
          "service": "base",
          "status": "pending",
          "link": "https://kyc.yativo.com/endorsement/base/c586066b-0f29-468f-b775-15483871a202"
        }
      ],
      "created_at": "2026-04-02T10:00:00.000000Z"
    }
  }
}