KYB API
KYB (Know Your Business)
KYB is the business verification procedure that covers company registration data, beneficial ownership, business activity, and reputation, using AI-based analysis of open sources.
How KYB differs from KYC
| Parameter | KYC | KYB |
|---|---|---|
| Verification subject | Individual | Legal entity (business) |
| API keys | kyc_live_* / kyc_test_* | kyb_live_* / kyb_test_* |
| Base URL | /tenant/v1/kyc/ | /tenant/v1/kyb/ |
| Primary entity | Applicant | Business |
| Result | Identity verified | Business verified |
Capabilities
- Automatic checks on the business through AI analysis of open sources
- Data extraction: name, registration number, executive officer, beneficial owners, activity types
- Risk assessment: AI Confirmation Flag and Risk Score
- Document upload: company charter, registration certificate
- Webhooks: verification result notifications in real time
Process architecture
- The tenant creates a verification link through
POST /tenant/v1/kyb/verification-links. - The end user goes through the KYB flow (entering company data, uploading documents).
- The AI service runs the business check in the background (typical time — 2–3 minutes).
- The tenant receives the result through the
kyb.business.verifiedwebhook or by pollingGET /tenant/v1/kyb/businesses/external/{id}.
Business lifecycle
[Created] → [In progress] → [Verified]
↓ ↓
[Rejected] [In review]Verification statuses:
| Status | Description |
|---|---|
pending | Business created, verification not yet complete |
verified | Business passed the checks |
rejected | Business rejected (failed the checks) |
review | Business routed to manual review by an operator |
AI Confirmation Flag
The AI service analyses open sources (state company registries, sanctions lists, press releases, court databases) and returns:
ai_confirmation_flag(true/false) — confirmation that the company exists and matches the provided data.risk_score(0–100) — risk score: higher values mean lower risk (mirrors the KYC verification scoring).
For the full result field reference, see KYB API reference.
Note. The KYB API is in beta. Endpoints and data formats may change. Track documentation updates.