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.
Related guides
- Requests: sync & async: webhooks, polling and time budgets
- Jurisdictions: identifiers and search fields per country
- Errors: what to do with a failed order's
code
Authorization
api_key Sign up at Kausate.com to get an API key
In: header
Query Parameters
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.
falseHeader Parameters
"2026-08-01"dateOptional 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