Company Data
Extract Ultimate Beneficial Owners (real-time)
Extract Ultimate Beneficial Owners from official registers.
Authorization
api_key X-API-Key<token>
Sign up at Kausate.com to get an API key
In: header
Path Parameters
kausateId*string
Query Parameters
sync?boolean
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.
Default
falseHeader Parameters
X-Partner-Customer-Id?|
Optional partner customer ID
Request Body
application/json
customerReference?|
bypassCache?boolean
If true, bypass daily deduplication and force a fresh request.
Default
falseResponse 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 "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"
},
"nationality": "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 may still be running in the background."
}{
"detail": [
{
"loc": [
"string"
],
"msg": "string",
"type": "string"
}
]
}{
"detail": "An internal error occurred"
}Last updated on