Search & prefill
Find a company and its kausateId with autocomplete, live search or an advanced query, then prefill its core data.
Every company endpoint takes a kausateId. Search is how you get one: each
autocomplete suggestion and each live search result carries the
kausateId of a company you can then order a report, documents or ownership
data for. Prefill is not a search. It takes a kausateId you already have and
returns that company's core data in one call.
Choose a search
| You have | Use | Mode | Returns |
|---|---|---|---|
| A few typed letters of a name | Autocomplete | Synchronous | Up to 50 name suggestions |
| A full or partial name, a registry number, both | Live search | Asynchronous or sync | Matching companies from the register |
| Registry-specific criteria | Live search with advancedQuery | Asynchronous or sync | Matching companies from the register |
A kausateId, and a form to fill | Prefill | Synchronous | A company report with the core fields |
Use autocomplete for a search box that updates as the user types. Use live search when you need the register's current answer: a name the suggestions do not contain, a registry number, or a company registered today. Prefill the form once the user has picked a result.
Each jurisdiction's guide lists which of these it supports, and
List Jurisdiction Capabilities
returns the same for your organization: autocomplete, live_search and
prefill each have a status, and enabled says whether your organization can
call it.
Autocomplete
GET /v2/companies/search/autocomplete matches company names by prefix and
answers in one synchronous call.
curl "https://api.kausate.com/v2/companies/search/autocomplete?query=N26&jurisdictionCode=de&limit=5" \
-H "X-API-Key: $API_KEY" \
-H "Kausate-Version: 2026-08-01"| Parameter | Meaning |
|---|---|
query | The name prefix, at least 2 characters. |
jurisdictionCode | Optional. Leave it out to suggest companies from every jurisdiction. |
limit | Number of suggestions, 10 by default and at most 50. |
dataSource | Optional. Picks one register where a jurisdiction has several. |
Each entry in results has a kausateId, jurisdictionCode, name and
identifiers. When the match was on another name the company is known by,
alternativeNames holds that name.
Live search
POST /v2/companies/search places a search order and returns an orderId.
Poll Get Live Search Order or
receive the result by webhook.
POST /v2/companies/search/sync waits for the result instead, for up to 300
seconds. See Requests: sync & async.
curl -X POST https://api.kausate.com/v2/companies/search/sync \
-H "X-API-Key: $API_KEY" \
-H "Kausate-Version: 2026-08-01" \
-H "Content-Type: application/json" \
-d '{"jurisdictionCode": "de", "companyName": "N26", "companyNumber": "HRB 271693"}'Send companyName, companyNumber or both. Kausate maps them onto the
jurisdiction's own search fields. Where a register searches by only one of
them, the other is ignored.
The completed order holds result.searchResults. Each result has a
kausateId, jurisdictionCode, name, alternativeNames, identifiers,
addresses and, where the register gives one, status.
Live search orders are never deduplicated: each one returns the register's answer at that moment. See Credits and billing.
Advanced query
advancedQuery searches by the fields a register itself offers, such as a
court and register type in Germany. Its fields differ by jurisdiction; the
How to search section of each jurisdiction guide lists
them with examples.
curl -X POST https://api.kausate.com/v2/companies/search/sync \
-H "X-API-Key: $API_KEY" \
-H "Kausate-Version: 2026-08-01" \
-H "Content-Type: application/json" \
-d '{
"jurisdictionCode": "de",
"advancedQuery": {"courtCity": "Berlin", "registerType": "HRB", "registerNumber": "271693"}
}'Send either advancedQuery or companyName and companyNumber, not both: a
request with both returns HTTP 422.
Prefill
POST /v2/companies/prefill takes a kausateId and returns a company report
for filling a form: name, status, legal form, addresses, identifiers and the
other core fields the jurisdiction provides. It always answers synchronously,
within 30 seconds, in the same shape as a company report.
curl -X POST https://api.kausate.com/v2/companies/prefill \
-H "X-API-Key: $API_KEY" \
-H "Kausate-Version: 2026-08-01" \
-H "Content-Type: application/json" \
-d '{"kausateId": "co_de_7aH2IUvdvC6XGzbUbSyhOU"}'Order a full company report when you need every section, such as officers and shareholders, rather than the core fields.
Run large searches
Add batch=true to a live search order when you search many companies at once
and do not need each answer immediately. Batch orders run at a lower priority
than your interactive ones, so a user waiting for a result is not queued behind
a bulk job. batch changes nothing else.
Last updated on