---
title: "KYB Beneficial Ownership Mapper"
method: POST
path: "/v1/tools/kyb_ubo_mapper"
---

# KYB Beneficial Ownership Mapper

`POST /v1/tools/kyb_ubo_mapper`

## Request

- Base URL: `https://ainumbers.co`
- URL: `https://ainumbers.co/v1/tools/kyb_ubo_mapper`
- Auth: none declared

Build UBO trees up to five layers deep. Input entity name, jurisdiction, ownership percentages — generates visual UBO tree, calculates control thresholds, flags

**Tool URL:** https://ainumbers.co/tools/111-kyb-ubo-mapper.html
**AP2/Policy Mandate export:** yes

## Request body

- object

## Response `200`

Successful tool execution result

- object
  - `uboChain` unknown[]
    - unknown
  - `controlPersons` unknown[]
    - unknown
  - `riskFlags` unknown[]
    - unknown
  - `mandateJson` object

---

[API](https://skmtc.dev/ainumbers/apis/ainumbers-co-fintech-intelligence-suite.md) · [All operations](https://skmtc.dev/ainumbers/apis/ainumbers-co-fintech-intelligence-suite/llms.txt) · [OpenAPI document](https://skmtc.dev/ainumbers/apis/ainumbers-co-fintech-intelligence-suite/revisions/b462e4f5bb28?raw)