KausateKausate Docs
Company report

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.

POST
/v2/companies/report
X-API-Key<token>

Sign up at Kausate.com to get an API key

In: header

Query Parameters

batch?boolean

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.

Defaultfalse

Header Parameters

Kausate-Version?string
Default"2026-08-01"
Formatdate
X-Customer-Id?|

Optional 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