KausateKausate Docs
Company search
Viewing API version 2026-05-01. View the latest version.

Company search: sync

Search for companies synchronously. Blocks for up to 300 seconds.

In production, order with the async POST /v2/companies/search endpoint: it returns an orderId at once, and the result reaches you by webhook or polling, however long the register takes.

POST
/v2/companies/search/sync
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-05-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/search/sync" \  -H "X-API-Key: $KAUSATE_API_KEY" \  -H "Kausate-Version: 2026-05-01" \  -H "Content-Type: application/json" \  -d '{  "companyName": "Lindt",  "jurisdictionCode": "de"}'
{
  "orderId": "live-search-de-lindt-org_01ABC-20240319143022",
  "customerReference": "search-ref-123",
  "status": "completed",
  "requestTime": "2024-03-19T14:30:22.787045Z",
  "responseTime": "2024-03-19T14:30:25.108791Z",
  "result": {
    "type": "liveSearch",
    "searchResults": [
      {
        "kausateId": "co_de_4JFFrsbQ99t1nmRw2JgzmG",
        "jurisdictionCode": "de",
        "name": "Lindt & Sprüngli GmbH",
        "identifiers": [
          {
            "value": "HRB 5754",
            "type": "de_registernumber_weak",
            "source": "de-handelsregister",
            "jurisdiction": "de",
            "description": "Amtsgericht Aachen"
          }
        ],
        "addresses": [
          {
            "type": "registered",
            "source": "registrar",
            "original": "Aachen",
            "normalized": {
              "road": "Süsterfeldstraße",
              "houseNumber": "130",
              "postcode": "52072",
              "city": "Aachen"
            }
          }
        ],
        "status": {
          "original": "aktiv",
          "normalized": "active",
          "isActive": true
        }
      }
    ]
  }
}
{
  "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": "The order did not complete within the timeout. Retry asynchronously and poll for the result.",
  "code": "request.timeout",
  "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