Identity Layer
KYB-AI
Coming soonBusiness verification — UBO identification, director screening, corporate structure analysis and registry cross-check. Supports legal entities across CA, AE and SA.
This plugin is in development. The API schema below is planned and subject to change. You can design your integration now using this reference.
Endpoint
POST
/api/kyb/verifyRequest parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
entity_id | string | Yes | Your internal reference for this business entity. |
jurisdiction | string | Yes | One of: CA, AE, SA. |
company_name | string | Yes | Registered company name. |
registration_number | string | Yes | Company registration / trade license number. |
registration_document | string | No | Base64-encoded registration document. |
ubo_list | array | No | List of Ultimate Beneficial Owners with name and ownership percentage. |
Response fields
| Parameter | Type | Required | Description |
|---|---|---|---|
data.status | string | Yes | approved, rejected, or review_required. |
data.company_verified | boolean | Yes | Whether the company registration was verified. |
data.ubo_flags | array | Yes | Compliance flags for each UBO. |
data.risk_level | string | Yes | low, medium, high, or critical. |
cURL
# Coming soon
curl -X POST \
https://shield.kodexa.systems/api/kyb/verify \
-H "Content-Type: application/json" \
-d '{...}'Code examples available when plugin launches