KausateKausate Docs
Company search

Company search: order (async)

Order a company search in the official register of one jurisdiction.

When to use it

Company search asks the register directly, by name, by registration number or by the jurisdiction's advanced fields. Use it when autocomplete has no match, or when you need a company registered today. Every result carries the kausateId that the company operations take. Search is never deduplicated: each request is a new order.

Example

Place the search, then read the result from resultUrl or receive it by webhook.

curl -X POST https://api.kausate.com/v2/companies/search \
  -H "X-API-Key: your_api_key" \
  -H "Kausate-Version: 2026-08-01" \
  -H "Content-Type: application/json" \
  -d '{
    "jurisdictionCode": "zz",
    "companyName": "Sandbox Logistics"
  }'

The order returns an orderId and a resultUrl at once. GET resultUrl returns the completed order. This one was recorded on the sandbox through the synchronous variant, which returns the same order:

{
  "orderId": "live-search-zz-sandbox-logistics-org_01ABC-20261121130000",
  "customerReference": null,
  "metadata": null,
  "customerId": null,
  "status": "completed",
  "requestTime": "2026-11-21T13:00:00Z",
  "responseTime": "2026-11-21T13:00:00Z",
  "result": {
    "type": "liveSearch",
    "searchResults": [
      {
        "kausateId": "co_zz_4O3wnpE5u1K5AXnkARuhp",
        "jurisdictionCode": "zz",
        "name": "Sandbox Logistics GmbH",
        "alternativeNames": null,
        "identifiers": [
          {
            "value": "820001",
            "type": "zz_sandbox_number",
            "source": "zz-sandbox",
            "jurisdiction": "zz",
            "description": "Kausate Sandbox Number",
            "extra": null
          }
        ],
        "addresses": [
          {
            "type": "registered",
            "source": "zz-sandbox",
            "original": "Am Sandtorkai 12, 20457 Hamburg, Germany",
            "normalized": null,
            "coordinate": null
          }
        ],
        "status": {
          "original": "Active",
          "normalized": "active",
          "isActive": true
        }
      },
      {
        "kausateId": "co_zz_7KAI2hNYkUCXF7l5HJvJ5M",
        "jurisdictionCode": "zz",
        "name": "Sandbox Logistics Holding GmbH",
        "alternativeNames": null,
        "identifiers": [
          {
            "value": "820002",
            "type": "zz_sandbox_number",
            "source": "zz-sandbox",
            "jurisdiction": "zz",
            "description": "Kausate Sandbox Number",
            "extra": null
          }
        ],
        "addresses": [
          {
            "type": "registered",
            "source": "zz-sandbox",
            "original": "Am Sandtorkai 12, 20457 Hamburg, Germany",
            "normalized": null,
            "coordinate": null
          }
        ],
        "status": {
          "original": "Active",
          "normalized": "active",
          "isActive": true
        }
      }
    ]
  },
  "error": null,
  "code": null,
  "currentActivity": null,
  "waitingMessage": null,
  "cachedOrder": false
}

To wait for the result in one call while testing, use POST /v2/companies/search/sync.

POST
/v2/companies/search
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

curl -X POST "https://api.kausate.com/v2/companies/search" \  -H "X-API-Key: $KAUSATE_API_KEY" \  -H "Kausate-Version: 2026-08-01" \  -H "Content-Type: application/json" \  -d '{  "companyName": "Lindt",  "jurisdictionCode": "de"}'
{
  "orderId": "live-search-de-lindt-org_01ABC-20240319143022",
  "customerReference": "search-ref-123",
  "metadata": {
    "team": "kyb",
    "ticket": "ACME-42"
  },
  "cachedOrder": false,
  "resultUrl": "/v2/companies/search/live-search-de-lindt-org_01ABC-20240319143022"
}
{
  "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": [
    {
      "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