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.
Related guides
- Quickstart: search, prefill, report and monitor, end to end
- Sandbox: the
zzcompanies used in these examples
Authorization
api_key Sign up at Kausate.com to get an API key
In: header
Query Parameters
2 <= length10Header Parameters
"2026-08-01"dateResponse 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