curl --request POST \
  --url https://app.sahlfinancial.com/api/v1/kyc/extract \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form files=@example-file \
  --form doc_type=payslip \
  --form step_key=proof_of_address \
  --form reference=client-0001 \
  --form environment=sandbox \
  --form 'subject=Test Client' \
  --form kind=individual

const form = new FormData();
form.append('files', '<string>');
form.append('doc_type', 'payslip');
form.append('step_key', 'proof_of_address');
form.append('reference', 'client-0001');
form.append('environment', 'sandbox');
form.append('subject', 'Test Client');
form.append('kind', 'individual');

const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};

options.body = form;

fetch('https://app.sahlfinancial.com/api/v1/kyc/extract', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://app.sahlfinancial.com/api/v1/kyc/extract"

files = { "files": ("example-file", open("example-file", "rb")) }
payload = {
    "doc_type": "payslip",
    "step_key": "proof_of_address",
    "reference": "client-0001",
    "environment": "sandbox",
    "subject": "Test Client",
    "kind": "individual"
}
headers = {"Authorization": "Bearer <token>"}

response = requests.post(url, data=payload, files=files, headers=headers)

print(response.text)

{
  "fields": {
    "first_name": "Test",
    "last_name": "Client",
    "document_holder_name": "Test Client",
    "employer_name": "Test Employer SARL",
    "occupation": "Analyst",
    "document_date": "2026-09-30"
  },
  "documents": [
    {
      "filename": "payslip-test.pdf",
      "doc_type": "payslip",
      "step_hint": "payslip",
      "step_key": null,
      "fields": {
        "first_name": "Test",
        "last_name": "Client",
        "document_holder_name": "Test Client",
        "employer_name": "Test Employer SARL",
        "occupation": "Analyst",
        "document_date": "2026-09-30"
      },
      "meta_created": "2026-10-01",
      "meta_provenance": {
        "producer": "Example Payroll 4.2",
        "revisions": 1
      },
      "mapped": 6,
      "notes": [],
      "document_id": "22222222-2222-4222-8222-222222222222"
    }
  ],
  "field_count": 6,
  "checks": [],
  "reader_unavailable": false,
  "policy": {
    "id": null,
    "version": 0,
    "source": "legacy",
    "regime": "none",
    "regulator": null,
    "purpose": "onboarding",
    "overrides_refused": []
  },
  "case_id": "00000000-0000-4000-8000-000000000001",
  "document_ids": [
    "22222222-2222-4222-8222-222222222222"
  ]
}

{
  "detail": "Send between 1 and 5 files."
}

{
  "detail": "Invalid or revoked API key"
}

{
  "detail": {
    "code": "kyc_scope_not_allowed",
    "message": "This workspace is not enabled for the partner KYC API."
  }
}

{
  "detail": "File too large. Maximum allowed size is 30 MB."
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>",
      "input": "<unknown>",
      "ctx": {}
    }
  ]
}

{
  "detail": {
    "code": "kyc_extract_cap_reached",
    "message": "Monthly document-read limit of 2000 reached.",
    "used": 2000,
    "limit": 2000
  }
}

{
  "code": "internal_error",
  "message": "An unexpected error occurred",
  "details": null
}