Extract Shareholder Graph
Place an order for a multi-level shareholder graph. Poll GET /v2/companies/shareholder-graph/{orderId} or subscribe via webhook.
Authorization
api_key Sign up at Kausate.com to get an API key
In: header
Query Parameters
Set to true for bulk, non-interactive requests. They run at lower priority than interactive requests.
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/shareholder-graph" \ -H "Kausate-Version: 2026-08-01" \ -H "Content-Type: application/json" \ -d '{ "kausateId": "string" }'{
"orderId": "string",
"kausateId": "string",
"customerReference": "string",
"metadata": {},
"customerId": "string",
"cachedOrder": true,
"resultUrl": "string"
}{
"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
Get Company Report OrderGET
Get the status of a company report order and, once complete, its result.
Extract Shareholder Graph (sync)POST
Extract a shareholder graph synchronously. Blocks for up to 300 seconds. Only `maxDepth=1` is supported for sync requests — deeper graphs exceed the 300s budget. Omitting `maxDepth` means 1 here; requests with `maxDepth>1` are rejected with 400; use the async `POST /v2/companies/shareholder-graph` endpoint for multi-level extraction.