KausateKausate Docs

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

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 /sync variants
  • Errors: the error body and the code to branch on

Last updated on

On this page