Skip to main content
POST
/
v2
/
companies
/
{kausateId}
/
ubo
Extract Ultimate Beneficial Owners (real-time)
curl --request POST \
  --url https://api.kausate.com/v2/companies/{kausateId}/ubo \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "customerReference": "<string>"
}
'
{
  "orderId": "ubo-D2601V_HRB******-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_******"
        }
      ]
    }
  }
}

Authorizations

​
X-API-Key
string
header
required

Sign up at Kausate.com to get an API key

Headers

​
X-Partner-Customer-Id
string | null

Optional partner customer ID

Path Parameters

​
kausateId
string
required

Company ID

Query Parameters

​
sync
boolean
default:false

Return result synchronously with 300s timeout

Body

application/json

Request model for UBO (Ultimate Beneficial Owner) extraction.

​
customerReference
string | null
Maximum string length: 150

Response

UBO extraction order successfully placed

  • ProductOrderResponse
  • UltimateBeneficialOwnerReport

Response model for product order.

​
orderId
string
required
​
customerReference
string | null
Maximum string length: 150
​
partnerCustomerId
string | null
Maximum string length: 150