curl -X POST 'https://kyc.yativo.com/api/individual-kyc/submit' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: kyc-ind-2026-001' \
  -d '{
    "customer_id": "c586066b-0f29-468f-b775-15483871a202",
    "first_name": "Alex",
    "last_name": "Smith",
    "email": "alex.smith@example.com",
    "calling_code": "+1",
    "phone": "5551234567",
    "gender": "male",
    "birth_date": "1990-01-15",
    "nationality": "US",
    "taxId": "998887766",
    "selfie_image": "https://storage.yativo.com/documents/abc/selfie.jpg",
    "residential_address": {
      "street_line_1": "123 Maple Street",
      "city": "Austin",
      "state": "TX",
      "postal_code": "78701",
      "country": "US",
      "proof_of_address_file": "https://storage.yativo.com/documents/abc/utility-bill.pdf"
    },
    "identifying_information": [
      {
        "type": "passport",
        "issuing_country": "US",
        "number": "P12345678",
        "date_issued": "2019-06-01",
        "expiration_date": "2029-06-01",
        "image_front_file": "https://storage.yativo.com/documents/abc/passport-front.jpg"
      }
    ],
    "employment_status": "employed",
    "most_recent_occupation_code": "151252",
    "expected_monthly_payments_usd": "0_4999",
    "source_of_funds": "salary",
    "account_purpose": "receive_salary",
    "acting_as_intermediary": false,
    "uploaded_documents": [
      {
        "type": "bank_statement",
        "file": "https://storage.yativo.com/documents/abc/bank-statement.pdf"
      }
    ]
  }'

const response = await fetch('https://kyc.yativo.com/api/individual-kyc/submit', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Idempotency-Key': `kyc-${customerId}-${Date.now()}`,
  },
  body: JSON.stringify({
    customer_id: customerId,
    first_name: 'Alex',
    last_name: 'Smith',
    email: 'alex.smith@example.com',
    calling_code: '+1',
    phone: '5551234567',
    gender: 'male',
    birth_date: '1990-01-15',
    nationality: 'US',
    taxId: '998887766',
    selfie_image: selfieUrl,
    residential_address: {
      street_line_1: '123 Maple Street',
      city: 'Austin',
      state: 'TX',
      postal_code: '78701',
      country: 'US',
      proof_of_address_file: addressProofUrl,
    },
    identifying_information: [{
      type: 'passport',
      issuing_country: 'US',
      number: 'P12345678',
      date_issued: '2019-06-01',
      expiration_date: '2029-06-01',
      image_front_file: passportFrontUrl,
    }],
    employment_status: 'employed',
    most_recent_occupation_code: '151252',
    expected_monthly_payments_usd: '0_4999',
    source_of_funds: 'salary',
    account_purpose: 'receive_salary',
    acting_as_intermediary: false,
    uploaded_documents: [{ type: 'bank_statement', file: statementUrl }],
  }),
});
const data = await response.json();

import requests

response = requests.post(
    'https://kyc.yativo.com/api/individual-kyc/submit',
    headers={
        'Content-Type': 'application/json',
        'Idempotency-Key': f'kyc-{customer_id}-001',
    },
    json={
        'customer_id': customer_id,
        'first_name': 'Alex',
        'last_name': 'Smith',
        'email': 'alex.smith@example.com',
        'calling_code': '+1',
        'phone': '5551234567',
        'gender': 'male',
        'birth_date': '1990-01-15',
        'nationality': 'US',
        'taxId': '998887766',
        'selfie_image': selfie_url,
        'residential_address': {
            'street_line_1': '123 Maple Street',
            'city': 'Austin',
            'state': 'TX',
            'postal_code': '78701',
            'country': 'US',
            'proof_of_address_file': address_proof_url,
        },
        'identifying_information': [{
            'type': 'passport',
            'issuing_country': 'US',
            'number': 'P12345678',
            'date_issued': '2019-06-01',
            'expiration_date': '2029-06-01',
            'image_front_file': passport_front_url,
        }],
        'employment_status': 'employed',
        'most_recent_occupation_code': '151252',
        'expected_monthly_payments_usd': '0_4999',
        'source_of_funds': 'salary',
        'account_purpose': 'receive_salary',
        'acting_as_intermediary': False,
        'uploaded_documents': [{'type': 'bank_statement', 'file': statement_url}],
    }
)

{
  "success": true,
  "message": "KYC submitted successfully.",
  "data": {
    "customer_id": "c586066b-0f29-468f-b775-15483871a202",
    "type": "individual",
    "status": "submitted",
    "first_name": "Alex",
    "last_name": "Smith",
    "email": "alex.smith@example.com",
    "submitted_at": "2026-10-20T10:00:00.000000Z"
  },
  "warnings": {
    "account_purpose": ["account_purpose is not one of the values from GET /api/individual-kyc/account-purposes; providers will reject it."]
  }
}

{
  "success": false,
  "message": "Validation error.",
  "validation_errors": {
    "nationality": ["The nationality field must be 2 characters."],
    "taxId": ["Tax ID must contain only letters and digits, up to 255 characters."]
  },
  "field_labels": {
    "nationality": "Nationality",
    "taxId": "Tax ID"
  },
  "field_hints": {}
}