KYC / KYB (AML)¶
Automates Know Your Customer / Know Your Business verification, biometrics, AML screening, and customer risk scoring.
| Repo | kyc-kyb-ai-backend/ |
| Runtime | Single FastAPI app (src/app.py) |
| Status | HTTP surfaces IMPLEMENTED; goAML XML library PARTIAL (no HTTP route) |
Why it exists¶
Onboarding and compliance need structured answers for identity and risk without hand-wiring Prembly, face models, and screening providers.
Capability map¶
Evidence: src/app.py + static OpenAPI platform-docs/docs/openapi/kyc-kyb.openapi.json.
| Area | Paths | Status |
|---|---|---|
| Health | GET /health |
IMPLEMENTED |
| ID | POST /prembly_id_check, POST /id_check/all |
IMPLEMENTED |
| Business | POST /prembly_business_check |
IMPLEMENTED |
| Address | POST /prembly_address_check |
IMPLEMENTED |
| Documents | POST /prembly_doc_check, POST /doc_extract, POST /doc_check/all |
IMPLEMENTED |
| Biodata | POST /biodata_check |
IMPLEMENTED |
| Report / risk | POST /generate_report, POST /calculate_customer_risk_profile |
IMPLEMENTED |
| Screening | POST /find_person, POST /open_sanction_finder, POST /pep_and_sanction_checker, POST /adverse_media_screener |
IMPLEMENTED |
| Biometrics | POST /liveliness_check, POST /face_comparison, POST /face_comparison/id_images, POST /edt/liveliness_check |
IMPLEMENTED |
| OpenSanctions download | /download, /download/all |
DEPRECATED (commented out in app.py) |
| goAML CTR/STR | src/report/aml_goaml/ |
PARTIAL — Excel→JSON→XML; not mounted on app.py |
Typical integrator sequence¶
- ID and/or document checks → 2. Liveliness + face comparison → 3. PEP / sanctions / adverse media → 4. Risk profile + report.
Orchestration order is owned by the calling app.
Auth note¶
app.py enables open CORS (allow_origins=["*"]). No bidirectional JWT dependency was found on these routes. Edge API-key / gateway behaviour per environment is UNKNOWN from this repo.