Beneficial owners: order (async)
Order the beneficial owners of a company from the official register. Poll the order status or subscribe via webhook.
When to use it
Order the beneficial owners of a company: the natural persons who own or control it, with the size and kind of their interest. For the full ownership chain behind the answer, order a shareholder graph.
Example
curl -X POST https://api.kausate.com/v2/companies/ubo \
-H "X-API-Key: your_api_key" \
-H "Kausate-Version: 2026-08-01" \
-H "Content-Type: application/json" \
-d '{"kausateId": "co_zz_4O3wnpE5u1K5AXnkARuhp"}'The completed order (GET resultUrl):
{
"orderId": "co_zz_4O3wnpE5u1K5AXnkARuhp-ubo-org_01ABC-20261121130000",
"kausateId": "co_zz_4O3wnpE5u1K5AXnkARuhp",
"companyName": "Sandbox Logistics GmbH",
"customerReference": null,
"metadata": null,
"customerId": null,
"status": "completed",
"requestTime": "2026-11-21T13:00:00Z",
"responseTime": "2026-11-21T13:00:00Z",
"result": {
"type": "uboReport",
"ultimateBeneficialOwnerReport": {
"sources": {
"zz-sandbox": {
"dataSource": "zz-sandbox",
"type": "primaryResearch",
"name": "Kausate Sandbox",
"jurisdictionCode": "zz",
"retrievalTime": "2026-11-21T13:00:00+00:00",
"downloadUrl": null,
"fileHash": null,
"fileName": null,
"date": null
}
},
"identifiers": null,
"ultimateBeneficialOwners": [
{
"type": "person",
"person": {
"address": null,
"contact": null,
"jurisdictionCode": "zz",
"dateOfBirth": null,
"gender": null,
"identifiers": null,
"name": {
"firstName": "Henrike",
"lastName": "Vossberg",
"fullName": "Henrike Vossberg"
},
"placeOfBirth": null,
"nationalities": null,
"taxResidencies": null
},
"company": null,
"interests": [
{
"type": "shareholding",
"directOrIndirect": null,
"percentage": {
"exact": 36,
"maximum": null,
"minimum": null,
"exclusiveMinimum": null,
"exclusiveMaximum": null
},
"details": null,
"startDate": null,
"endDate": null
}
],
"source": "zz-sandbox"
}
]
}
},
"error": null,
"code": null,
"currentActivity": null,
"waitingMessage": null,
"cachedOrder": false
}Henrike Vossberg, the largest owner of Sandbox Group SE, owns Sandbox Logistics
GmbH indirectly, through three holding companies; percentage is her effective
share of it. The shareholder graph
shows the chain itself.
Related guides
- Jurisdictions: where beneficial ownership is available
- Requests: sync & async: webhooks, polling and daily deduplication
Authorization
api_key Sign up at Kausate.com to get an API key
In: header
Query Parameters
Set to true for batch orders: many orders you submit together and do not need answered immediately. They run at a lower priority than interactive orders.
falseHeader Parameters
"2026-08-01"dateOptional customer ID
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://api.kausate.com/v2/companies/ubo" \ -H "X-API-Key: $KAUSATE_API_KEY" \ -H "Kausate-Version: 2026-08-01" \ -H "Content-Type: application/json" \ -d '{ "kausateId": "co_zz_4O3wnpE5u1K5AXnkARuhp"}'{
"orderId": "co_de_4JFFrsbQ99t1nmRw2JgzmG-ubo-org_01ABC-20240319",
"customerReference": "my-ref-123",
"metadata": {
"team": "kyb",
"ticket": "ACME-42"
},
"cachedOrder": false,
"resultUrl": "/v2/companies/ubo/co_de_4JFFrsbQ99t1nmRw2JgzmG-ubo-org_01ABC-20240319"
}{
"detail": "Invalid company ID format",
"code": "request.invalid",
"request_id": "req_01J8Z5V4Q2X9N7B3C6D1E0F2G4"
}{
"detail": "API key is required",
"code": "auth.unauthorized",
"request_id": "req_01J8Z5V4Q2X9N7B3C6D1E0F2G4"
}{
"detail": "Invalid API key",
"code": "auth.forbidden",
"request_id": "req_01J8Z5V4Q2X9N7B3C6D1E0F2G4"
}{
"detail": "Company not found",
"code": "company.not_found",
"request_id": "req_01J8Z5V4Q2X9N7B3C6D1E0F2G4"
}{
"detail": [
{
"loc": [
"body",
"kausateId"
],
"msg": "Field required",
"type": "missing"
}
],
"code": "request.invalid",
"request_id": "req_01J8Z5V4Q2X9N7B3C6D1E0F2G4"
}{
"detail": "The data source is rate-limiting requests right now, please try again later",
"code": "source.rate_limited",
"request_id": "req_01J8Z5V4Q2X9N7B3C6D1E0F2G4"
}{
"detail": "An unexpected error occurred. If this persists, please contact support@kausate.com",
"code": "internal.unexpected",
"request_id": "req_01J8Z5V4Q2X9N7B3C6D1E0F2G4"
}{
"detail": "This capability is offered for the requested jurisdiction but is not usable right now because of a fault on our side. Please contact support@kausate.com",
"code": "capability.not_available",
"request_id": "req_01J8Z5V4Q2X9N7B3C6D1E0F2G4"
}{
"detail": "Network error while reaching the data source",
"code": "source.network_error",
"request_id": "req_01J8Z5V4Q2X9N7B3C6D1E0F2G4"
}{
"detail": "Data source temporarily unavailable",
"code": "source.unavailable",
"request_id": "req_01J8Z5V4Q2X9N7B3C6D1E0F2G4"
}Last updated on