Extract Ultimate Beneficial Owners
Extract Ultimate Beneficial Owners from official registers.
Authorization
api_key Sign up at Kausate.com to get an API key
In: header
Path Parameters
Company ID
Query Parameters
Return result synchronously with 300s timeout. Not recommended: government registries are unreliable and timeouts are common. Use default async mode with webhooks (recommended) or polling using the orderId instead.
falseMark as a batch/backfill request. Batch requests run at lowest priority to avoid blocking interactive queries.
falseHeader Parameters
"2025-04-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
curl -X POST "https://api.kausate.com/v2/companies/string/ubo" \ -H "Kausate-Version: 2025-04-01" \ -H "Content-Type: application/json" \ -d '{}'{
"orderId": "ubo-4JFFrsbQ99t1nmRw2JgzmG-20240319143022",
"customerReference": "my-ref-123",
"status": "completed",
"requestTime": "2024-03-19T14:30:22.787045Z",
"responseTime": "2024-03-19T14:32:45.108791Z",
"result": {
"ultimateBeneficialOwnerReport": {
"sources": {
"transparenzregister******": {
"type": "officialRegister",
"name": "Transparenzregister Deutschland",
"jurisdictionCode": "de",
"retrievalTime": "2024-03-19T14:30:50.996406",
"downloadUrl": "https://example.com/path/to/ubo.pdf",
"fileHash": "abc123def456...",
"fileName": "UBO_list_abc123def456.pdf",
"date": {
"original": "2024-03-19",
"normalized": "2024-03-19"
}
}
},
"ultimateBeneficialOwners": [
{
"type": "person",
"person": {
"jurisdictionCode": "de",
"dateOfBirth": {
"original": "1970-01-01",
"normalized": "1970-01-01"
},
"name": {
"firstName": "John",
"lastName": "Doe",
"fullName": "John Doe"
},
"nationalities": [
{
"original": "Germany",
"countryCode": "DE"
}
]
},
"interests": [
{
"type": "shareholding",
"percentage": {
"exact": 25
},
"details": "Direct shareholding"
}
],
"source": "handelsregister_ubo_******"
}
]
}
}
}{
"detail": "Invalid company ID format"
}{
"detail": "Invalid API key"
}{
"detail": "Insufficient credits. Required: 10, Available: 5"
}{
"detail": "Company not found"
}{
"detail": "Request timed out after 300 seconds. The workflow has been cancelled."
}{
"detail": [
{
"loc": [
"string"
],
"msg": "string",
"type": "string",
"input": null,
"ctx": {}
}
]
}{
"detail": "An internal error occurred"
}Last updated on
Quote Shareholder Graph ExtensionPOST
Quote what extending a completed shareholder graph would cost — before ordering. Takes the same body as POST /v2/companies/shareholder-graph/{orderId}/extend and resolves exactly which nodes that extension would extend, pricing each at your organization's effective credit price for the node's jurisdiction extension SKU. Nodes the extension would skip (and never charge) are listed under `excludedNodes` with the reason. No workflow is started and nothing is charged. If every requested node is excluded, `orderWouldFail` is `true`: an identical extend order would be accepted but then fail asynchronously instead of completing as a free no-op.
Get Company Report RunGET
Retrieve typed status for a company report run.