Quickstart
Get an API key, find a sandbox company and order its company report in three calls.
Make your first calls against the sandbox: find a company, then order its company report. The calls are the same in every jurisdiction. For the whole KYB check on one company, from search to beneficial owners, documents and a monitor's webhook, follow the KYB walkthrough.
Get an API key
- Self-serve: create an account at kausate.com/signup and generate a key in the dashboard.
- Enterprise: contact us.
Send the key as X-API-Key (Authentication) and pin the API
version with Kausate-Version (Versioning). Export the
key, and the samples below run as they are:
export KAUSATE_API_KEY="your_api_key"Find a company
Autocomplete returns matching companies, each with the kausateId every
other call takes:
curl "https://api.kausate.com/v2/companies/search/autocomplete?query=Sandbox+Logistics&jurisdictionCode=zz" \
-H "X-API-Key: $KAUSATE_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
}
]
}
]
}Order its company report
Ordering returns an orderId and a resultUrl at once:
curl -X POST "https://api.kausate.com/v2/companies/report" \
-H "X-API-Key: $KAUSATE_API_KEY" \
-H "Kausate-Version: 2026-08-01" \
-H "Content-Type: application/json" \
-d '{
"kausateId": "co_zz_4O3wnpE5u1K5AXnkARuhp",
"bypassCache": true
}'{
"orderId": "co_zz_4O3wnpE5u1K5AXnkARuhp-report-org_01ABC-20261121130000",
"kausateId": "co_zz_4O3wnpE5u1K5AXnkARuhp",
"customerReference": null,
"metadata": null,
"customerId": null,
"cachedOrder": false,
"resultUrl": "/v2/companies/report/co_zz_4O3wnpE5u1K5AXnkARuhp-report-org_01ABC-20261121130000"
}Fetch your order's resultUrl until status is completed, or receive the
result by webhook (Sync and async):
curl "https://api.kausate.com/v2/companies/report/co_zz_4O3wnpE5u1K5AXnkARuhp-report-org_01ABC-20261121130000" \
-H "X-API-Key: $KAUSATE_API_KEY" \
-H "Kausate-Version: 2026-08-01"Next steps
- KYB walkthrough: beneficial owners, shareholder graph, documents, financials and monitoring on the same company
- Search: autocomplete, live search and prefill
- Sync and async: webhooks, polling and the
/syncvariants - Errors: the error body and the
codeto branch on
Last updated on