KausateKausate Docs

Autocomplete

Suggest companies by name as the user types, matched by name prefix. Returns up to `limit` companies (default 10, maximum 50).

When to use it

Use autocomplete behind a search box: it answers while the user types, matches companies by the start of their name, and returns up to limit candidates (default 10, at most 50) with their kausateId. It answers immediately; no order is placed. When the company is not in the results, or you only have a registration number, use company search, which queries the register itself.

Example

curl "https://api.kausate.com/v2/companies/search/autocomplete?query=Sandbox%20Logistics&jurisdictionCode=zz" \
  -H "X-API-Key: your_api_key" \
  -H "Kausate-Version: 2026-08-01"
{
  "results": [
    {
      "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
        }
      ]
    },
    {
      "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
        }
      ]
    }
  ]
}

Pass the kausateId to any company operation: report, documents, shareholder graph, beneficial owners or monitoring.

  • Quickstart: search, prefill, report and monitor, end to end
  • Sandbox: the zz companies used in these examples
GET
/v2/companies/search/autocomplete
X-API-Key<token>

Sign up at Kausate.com to get an API key

In: header

Query Parameters

jurisdictionCode?|
query*string
Length2 <= length
limit?|
Default10
dataSource?|

Header Parameters

Kausate-Version?string
Default"2026-08-01"
Formatdate

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl "https://api.kausate.com/v2/companies/search/autocomplete?jurisdictionCode=zz&query=Sandbox+Logistics" \  -H "X-API-Key: $KAUSATE_API_KEY" \  -H "Kausate-Version: 2026-08-01"
{
  "results": [
    {
      "kausateId": "string",
      "jurisdictionCode": "aa",
      "name": "string",
      "alternativeNames": "string",
      "identifiers": [
        {
          "value": "string",
          "type": "ad_commercial_register_number",
          "source": "aa-aggregated",
          "jurisdiction": "aa",
          "description": "string",
          "extra": {}
        }
      ]
    }
  ]
}
{
  "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