curl --request POST \
--url https://api.openregisters.com/v2/companies/{kausateId}/shareholder-graph \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '{
"customerReference": "<string>",
"maxDepth": 3
}'
{
"orderId": "shareholder-graph-co_de_abc123-20240319143022",
"customerReference": "my-ref-123",
"status": "completed",
"requestTime": "2024-03-19T14:30:22.787045Z",
"responseTime": "2024-03-19T14:35:45.108791Z",
"result": {
"graph": {
"nodes": [
{
"id": "co_de_abc123",
"type": "rootEntity",
"data": {
"kausateId": "co_de_abc123",
"legalName": "Parent Company GmbH",
"jurisdictionCode": "de",
"identifiers": [
{
"value": "co_de_abc123",
"type": "kausate_id",
"description": "Kausate universal company identifier"
},
{
"value": "D2601V_HRB123456",
"type": "de_registernumber_full",
"description": "German commercial register number with court code"
}
],
"cumulativeOwnership": 100,
"shareholderReport": {
"sources": {
"handelsregister_shareholder_abc123": {
"type": "registrar",
"name": "Handelsregister Deutschland",
"jurisdictionCode": "de",
"retrievalTime": "2024-03-19T14:30:00Z",
"downloadUrl": "https://www.kausate.com/downloads/sample.pdf",
"fileHash": "abc123...",
"fileName": "sample.pdf",
"date": {
"original": "2024-03-15",
"normalized": "2024-03-15"
}
}
},
"shareholders": [
{
"type": "company",
"company": {
"name": "Subsidiary AG",
"jurisdictionCode": "de",
"identifier": [
{
"value": "HRB 98765",
"type": "de_registernumber_weak",
"description": "AG Frankfurt"
},
{
"value": "co_de_xyz789",
"type": "kausate_id",
"description": "Kausate Universal Identifier"
}
]
},
"numberOfShares": 750,
"percentage": 75,
"totalNominalValue": {
"amount": "75000",
"iso4217CurrencyCode": "EUR"
},
"source": "handelsregister_shareholder_abc123"
},
{
"type": "person",
"person": {
"jurisdictionCode": "de",
"name": {
"firstName": "John",
"lastName": "Doe",
"fullName": "John Doe"
}
},
"numberOfShares": 250,
"percentage": 25,
"totalNominalValue": {
"amount": "25000",
"iso4217CurrencyCode": "EUR"
},
"source": "handelsregister_shareholder_abc123"
}
]
}
}
},
{
"id": "co_de_xyz789",
"type": "company",
"data": {
"kausateId": "co_de_xyz789",
"legalName": "Subsidiary AG",
"jurisdictionCode": "de",
"identifiers": [
{
"value": "co_de_xyz789",
"type": "kausate_id",
"description": "Kausate universal company identifier"
},
{
"value": "HRB 98765",
"type": "de_registernumber_weak",
"description": "German commercial register number"
}
],
"cumulativeOwnership": 75
}
},
{
"id": "person_John_Doe",
"type": "person",
"data": {
"name": "John Doe",
"cumulativeOwnership": 25
}
}
],
"edges": [
{
"id": "co_de_abc123-co_de_xyz789",
"source": "co_de_abc123",
"target": "co_de_xyz789",
"data": {
"percentage": 75,
"numberOfShares": 750,
"totalNominalValue": {
"amount": "75000",
"iso4217CurrencyCode": "EUR"
}
}
},
{
"id": "co_de_abc123-person_John_Doe",
"source": "co_de_abc123",
"target": "person_John_Doe",
"data": {
"percentage": 25,
"numberOfShares": 250,
"totalNominalValue": {
"amount": "25000",
"iso4217CurrencyCode": "EUR"
}
}
}
],
"rootCompanyId": "co_de_abc123",
"maxDepth": 3,
"extractionTimestamp": "2024-03-19T14:30:22Z"
},
"errors": [],
"warnings": [],
"extractedCompanies": [
"co_de_abc123",
"co_de_xyz789"
]
}
}
Extract multi-level shareholder graph showing shareholders and their shareholders.
This endpoint builds a complete shareholder graph by recursively extracting shareholders at multiple levels.
Key Features:
Typical workflow:
GET /v2/companies/search/indexed?name=...&jurisdictionCode=...
to find the companyPOST /v2/companies/{kausateId}/shareholder-graph
with depth settingsGET /v2/orders/{orderId}
for the complete graph resultParameters:
Returns: Order ID for tracking the extraction (poll for results)
Note: This is a compute-intensive operation that may take 5-15 minutes depending on depth.
curl --request POST \
--url https://api.openregisters.com/v2/companies/{kausateId}/shareholder-graph \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '{
"customerReference": "<string>",
"maxDepth": 3
}'
{
"orderId": "shareholder-graph-co_de_abc123-20240319143022",
"customerReference": "my-ref-123",
"status": "completed",
"requestTime": "2024-03-19T14:30:22.787045Z",
"responseTime": "2024-03-19T14:35:45.108791Z",
"result": {
"graph": {
"nodes": [
{
"id": "co_de_abc123",
"type": "rootEntity",
"data": {
"kausateId": "co_de_abc123",
"legalName": "Parent Company GmbH",
"jurisdictionCode": "de",
"identifiers": [
{
"value": "co_de_abc123",
"type": "kausate_id",
"description": "Kausate universal company identifier"
},
{
"value": "D2601V_HRB123456",
"type": "de_registernumber_full",
"description": "German commercial register number with court code"
}
],
"cumulativeOwnership": 100,
"shareholderReport": {
"sources": {
"handelsregister_shareholder_abc123": {
"type": "registrar",
"name": "Handelsregister Deutschland",
"jurisdictionCode": "de",
"retrievalTime": "2024-03-19T14:30:00Z",
"downloadUrl": "https://www.kausate.com/downloads/sample.pdf",
"fileHash": "abc123...",
"fileName": "sample.pdf",
"date": {
"original": "2024-03-15",
"normalized": "2024-03-15"
}
}
},
"shareholders": [
{
"type": "company",
"company": {
"name": "Subsidiary AG",
"jurisdictionCode": "de",
"identifier": [
{
"value": "HRB 98765",
"type": "de_registernumber_weak",
"description": "AG Frankfurt"
},
{
"value": "co_de_xyz789",
"type": "kausate_id",
"description": "Kausate Universal Identifier"
}
]
},
"numberOfShares": 750,
"percentage": 75,
"totalNominalValue": {
"amount": "75000",
"iso4217CurrencyCode": "EUR"
},
"source": "handelsregister_shareholder_abc123"
},
{
"type": "person",
"person": {
"jurisdictionCode": "de",
"name": {
"firstName": "John",
"lastName": "Doe",
"fullName": "John Doe"
}
},
"numberOfShares": 250,
"percentage": 25,
"totalNominalValue": {
"amount": "25000",
"iso4217CurrencyCode": "EUR"
},
"source": "handelsregister_shareholder_abc123"
}
]
}
}
},
{
"id": "co_de_xyz789",
"type": "company",
"data": {
"kausateId": "co_de_xyz789",
"legalName": "Subsidiary AG",
"jurisdictionCode": "de",
"identifiers": [
{
"value": "co_de_xyz789",
"type": "kausate_id",
"description": "Kausate universal company identifier"
},
{
"value": "HRB 98765",
"type": "de_registernumber_weak",
"description": "German commercial register number"
}
],
"cumulativeOwnership": 75
}
},
{
"id": "person_John_Doe",
"type": "person",
"data": {
"name": "John Doe",
"cumulativeOwnership": 25
}
}
],
"edges": [
{
"id": "co_de_abc123-co_de_xyz789",
"source": "co_de_abc123",
"target": "co_de_xyz789",
"data": {
"percentage": 75,
"numberOfShares": 750,
"totalNominalValue": {
"amount": "75000",
"iso4217CurrencyCode": "EUR"
}
}
},
{
"id": "co_de_abc123-person_John_Doe",
"source": "co_de_abc123",
"target": "person_John_Doe",
"data": {
"percentage": 25,
"numberOfShares": 250,
"totalNominalValue": {
"amount": "25000",
"iso4217CurrencyCode": "EUR"
}
}
}
],
"rootCompanyId": "co_de_abc123",
"maxDepth": 3,
"extractionTimestamp": "2024-03-19T14:30:22Z"
},
"errors": [],
"warnings": [],
"extractedCompanies": [
"co_de_abc123",
"co_de_xyz789"
]
}
}
Sign up at Kausate.com to get an API key
Company ID
Request model for multi-level shareholder extraction (shareholder graph).
Multi-level shareholder graph extraction order successfully placed
Response model for product order.