Company report: order (async)
Place an order for a structured company report. Poll GET /v2/companies/report/{orderId} or subscribe via webhook.
When to use it
Order a company report for the register record of one company. Every report
carries basicInformation: name, status, legal form, identifiers, addresses
and activities. Omit dataSections to receive the jurisdiction's default
report, or request legalRepresentatives, shareholders, subsidiaries or
allAvailable; requested sections are added to the default and billed as
additional sections. Each data point names the source it came from in
sources. Use it for onboarding and periodic reviews;
use prefill when you only need to fill
a form quickly.
The same request for the same company on the same UTC day returns the existing
order and is not charged again. Set bypassCache: true to place a fresh one.
Example
curl -X POST https://api.kausate.com/v2/companies/report \
-H "X-API-Key: your_api_key" \
-H "Kausate-Version: 2026-08-01" \
-H "Content-Type: application/json" \
-d '{"kausateId": "co_zz_4O3wnpE5u1K5AXnkARuhp"}'{
"orderId": "co_zz_4O3wnpE5u1K5AXnkARuhp-report-org_01ABC-20261121130000",
"kausateId": "co_zz_4O3wnpE5u1K5AXnkARuhp",
"customerReference": null,
"metadata": null,
"customerId": null,
"cachedOrder": false,
"resultUrl": "/v2/companies/report/co_zz_4O3wnpE5u1K5AXnkARuhp-report-org_01ABC-20261121130000"
}When the order completes, the webhook delivers the report and
GET resultUrl returns it:
{
"orderId": "co_zz_4O3wnpE5u1K5AXnkARuhp-report-org_01ABC-20261121130000",
"kausateId": "co_zz_4O3wnpE5u1K5AXnkARuhp",
"companyName": "Sandbox Logistics GmbH",
"customerReference": null,
"metadata": null,
"customerId": null,
"status": "completed",
"requestTime": "2026-11-21T13:00:00Z",
"responseTime": "2026-11-21T13:00:00Z",
"result": {
"type": "companyReport",
"companyReport": {
"sources": {
"zz-sandbox": {
"dataSource": "zz-sandbox",
"type": "primaryResearch",
"name": "Kausate Sandbox",
"jurisdictionCode": "zz",
"retrievalTime": "2026-11-21T13:00:00+00:00",
"downloadUrl": null,
"fileHash": null,
"fileName": null,
"date": null
}
},
"risk": null,
"basicInformation": {
"type": "organization",
"legalName": "Sandbox Logistics GmbH",
"alternativeNames": null,
"status": {
"original": "Active",
"normalized": "active",
"isActive": true
},
"statusEvents": null,
"legalForm": {
"original": "GmbH",
"normalized": "Gesellschaft mit beschränkter Haftung",
"iso20275LegalFormCode": null,
"category": "LLC"
},
"representationPolicy": null,
"capital": {
"currency": {
"amount": "100000",
"iso4217CurrencyCode": "EUR"
},
"issued": null,
"authorized": null
},
"identifiers": [
{
"value": "820001",
"type": "zz_sandbox_number",
"source": "zz-sandbox",
"jurisdiction": "zz",
"description": "Kausate Sandbox Number",
"extra": null
}
],
"dates": {
"incorporationDate": {
"original": "2015-04-01",
"normalized": "2015-04-01"
},
"lastChanged": null
},
"addresses": [
{
"type": "registered",
"source": "zz-sandbox",
"original": "Dradenaustraße 33, 21129 Hamburg, Germany",
"normalized": null,
"coordinate": null
}
],
"activities": [
{
"scheme": "nace_rev_2",
"code": "52.29",
"description": "Other transportation support activities",
"source": "zz-sandbox",
"isPrimary": true,
"confidence": null
},
{
"scheme": "nace_rev_2",
"code": "49.41",
"description": "Freight transport by road",
"source": "zz-sandbox",
"isPrimary": false,
"confidence": null
}
],
"contacts": null,
"employeeCount": null,
"bankAccounts": null
},
"relationships": {
"legalRepresentatives": [
{
"type": "person",
"person": {
"address": null,
"contact": null,
"jurisdictionCode": "zz",
"dateOfBirth": null,
"gender": null,
"identifiers": null,
"name": {
"firstName": "Lukas",
"lastName": "Brandt",
"fullName": "Lukas Brandt"
},
"placeOfBirth": null,
"nationalities": null,
"taxResidencies": null
},
"company": null,
"role": {
"original": "Managing Director",
"englishTranslation": null,
"originalLanguage": null,
"iso5009RoleCode": null,
"normalized": "Managing Director"
},
"startDate": null,
"source": "zz-sandbox"
},
{
"type": "person",
"person": {
"address": null,
"contact": null,
"jurisdictionCode": "zz",
"dateOfBirth": null,
"gender": null,
"identifiers": null,
"name": {
"firstName": "Petra",
"lastName": "Lindqvist",
"fullName": "Petra Lindqvist"
},
"placeOfBirth": null,
"nationalities": null,
"taxResidencies": null
},
"company": null,
"role": {
"original": "Authorized Signatory",
"englishTranslation": null,
"originalLanguage": null,
"iso5009RoleCode": null,
"normalized": "Authorized Signatory"
},
"startDate": null,
"source": "zz-sandbox"
}
],
"branches": null,
"shareholders": [
{
"type": "company",
"person": null,
"company": {
"name": "Sandbox Logistics Holding GmbH",
"address": null,
"legalForm": null,
"jurisdictionCode": "zz",
"identifiers": [
{
"value": "co_zz_7KAI2hNYkUCXF7l5HJvJ5M",
"type": "kausate_id",
"source": "zz-sandbox",
"jurisdiction": "zz",
"description": null,
"extra": null
},
{
"value": "820002",
"type": "zz_sandbox_number",
"source": "zz-sandbox",
"jurisdiction": "zz",
"description": null,
"extra": null
}
],
"status": null,
"activities": null
},
"numberOfShares": null,
"percentage": {
"exact": 90,
"maximum": null,
"minimum": null,
"exclusiveMinimum": null,
"exclusiveMaximum": null
},
"jointHolding": null,
"shareClass": null,
"totalNominalValue": null,
"role": null,
"interestType": "shareholding",
"interestDetails": null,
"risk": null,
"description": null,
"source": "zz-sandbox"
},
{
"type": "person",
"person": {
"address": null,
"contact": null,
"jurisdictionCode": "zz",
"dateOfBirth": null,
"gender": null,
"identifiers": null,
"name": {
"firstName": "Kai",
"lastName": "Brenner",
"fullName": "Kai Brenner"
},
"placeOfBirth": null,
"nationalities": null,
"taxResidencies": null
},
"company": null,
"numberOfShares": null,
"percentage": {
"exact": 10,
"maximum": null,
"minimum": null,
"exclusiveMinimum": null,
"exclusiveMaximum": null
},
"jointHolding": null,
"shareClass": null,
"totalNominalValue": null,
"role": null,
"interestType": "shareholding",
"interestDetails": null,
"risk": null,
"description": null,
"source": "zz-sandbox"
}
],
"subsidiaries": null,
"ownershipIncompleteReason": null,
"contractualInterests": null,
"legalPredecessors": null,
"legalSuccessors": null
},
"errors": []
}
},
"error": null,
"code": null,
"currentActivity": null,
"waitingMessage": null,
"cachedOrder": false
}Always read original next to normalized; the original is the register's
own wording.
Related guides
- Quickstart: from search to report to monitor
- Requests: sync & async: webhooks, polling and daily deduplication
- Jurisdictions: which data points each country returns
- Errors: codes on a failed order
Authorization
api_key Sign up at Kausate.com to get an API key
In: header
Query Parameters
Set to true for batch orders: many orders you submit together and do not need answered immediately. They run at a lower priority than interactive orders.
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/report" \ -H "X-API-Key: $KAUSATE_API_KEY" \ -H "Kausate-Version: 2026-08-01" \ -H "Content-Type: application/json" \ -d '{ "kausateId": "co_zz_4O3wnpE5u1K5AXnkARuhp"}'{
"orderId": "co_de_4JFFrsbQ99t1nmRw2JgzmG-report-org_01ABC-20240319",
"customerReference": "my-ref-123",
"metadata": {
"team": "kyb",
"ticket": "ACME-42"
},
"cachedOrder": false,
"resultUrl": "/v2/companies/report/co_de_4JFFrsbQ99t1nmRw2JgzmG-report-org_01ABC-20240319"
}{
"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