Live Search
Search Companies (real-time)
Search for companies in real-time from official business registries. Returns results with Kausate IDs.
Authorization
api_key X-API-Key<token>
Sign up at Kausate.com to get an API key
In: header
Query Parameters
sync?boolean
If true (default), wait for results and return them directly. If false, return an orderId immediately. Results will be delivered via webhook (recommended) or can be polled using GET /v2/companies/search/runs/{orderId}.
Default
trueHeader Parameters
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
curl -X POST "https://api.staging.kausate.com/v2/companies/search/" \ -H "Content-Type: application/json" \ -d '{ "companyName": "Lindt", "jurisdictionCode": "de" }'{
"orderId": "de-live-search-lindt-20240319143022",
"customerReference": "search-ref-123"
}{
"detail": "Invalid company ID format"
}{
"detail": "Invalid API key"
}{
"detail": [
{
"loc": [
"string"
],
"msg": "string",
"type": "string"
}
]
}{
"detail": "An internal error occurred"
}Last updated on