Beneficial Ownership (UBO) Check

Business & KYB

Trace who ultimately owns and controls a company.

Resolve the shareholding and directorship chain behind a CIN to the natural persons who hold significant control, with their percentages and roles, for AML and KYB obligations.

Endpoint

POST https://app.emver.io/api/sandbox/v1/ubo-check

Authorization: Bearer YOUR_API_KEY

Content-Type: application/json

Accept: application/json

Request parameters

Field	Type	Description
`cin` required	string	CIN / LLPIN
`threshold` optional	number	Ownership threshold (%)

Example request

cURL

curl -X POST https://app.emver.io/api/sandbox/v1/ubo-check \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "cin": "string",
    "threshold": 0
}'

import requests

response = requests.post(
    "https://app.emver.io/api/sandbox/v1/ubo-check",
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "Accept": "application/json",
    },
    json={
        "cin": "string",
        "threshold": 0
    },
    timeout=60,
)
response.raise_for_status()
data = response.json()

const response = await fetch("https://app.emver.io/api/sandbox/v1/ubo-check", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
    "Accept": "application/json",
  },
  body: JSON.stringify({
      "cin": "string",
      "threshold": 0
  }),
});

const data = await response.json();

$response = Http::withToken('YOUR_API_KEY')
    ->acceptJson()
    ->post('https://app.emver.io/api/sandbox/v1/ubo-check', {
        "cin": "string",
        "threshold": 0
    });

$data = $response->json();

Replace YOUR_API_KEY and the placeholder values. Use the switch above to see production URLs.

Response

Structure · 200

{
  "status": INTEGER,
  "message": STRING,
  "data": {
    "beneficial_owners": ARRAY,
    "ownership_chain": ARRAY,
    "as_of": DATE
  }
}

Example · 200

{
  "status": 200,
  "message": "string",
  "data": {
    "beneficial_owners": "string",
    "ownership_chain": "string",
    "as_of": "YYYY-MM-DD"
  }
}

Error · 4xx / 5xx

{
  "status": INTEGER,
  "message": STRING
}

See Errors & status codes for what each status means and which calls are billed.

About this API

The API walks the registered shareholding and significant-beneficial-owner filings up the chain and returns the individuals identified as beneficial owners together with the path by which they qualify.

Typical uses

Corporate account opening. Mandatory UBO identification for KYB.
Vendor and partner due diligence. Know who you are really contracting with.

Questions

What threshold is used by default?: Ten percent, the statutory significant-beneficial-owner threshold. Override it per request.