# Kausate

Real-time company data API for KYB. AI coding assistants integrating Kausate should start with the agent artifacts below — they encode the production-ready patterns (async + webhooks, customerId / customerReference, polling fallback, OpenAPI client generation).

## Agent integration

- [AGENTS.md template](https://docs.kausate.com/agents/kausate.md): drop into your repo as AGENTS.md (works with Codex, Cursor, Copilot, Gemini CLI, Junie, Aider; Claude Code reads it via a one-line @AGENTS.md import in CLAUDE.md)
- [Integration skill](https://docs.kausate.com/plugins/kausate-integration/skills/kausate-integration/SKILL.md): on-demand skill for AI coding assistants
- [Skills manifest](https://docs.kausate.com/.well-known/skills/index.json)

## Live OpenAPI

- [openapi.json](https://api.kausate.com/openapi.json): full API surface (requires X-API-Key)

## Overview

- [Introduction](https://docs.kausate.com/index.md): Access authoritative company data across multiple jurisdictions

## Api Reference

- [API version 2025-04-01](https://docs.kausate.com/api-reference/2025-04-01.md): Historical snapshot of the Kausate API as of 2025-04-01.
- [Extract Shareholder Graph](https://docs.kausate.com/api-reference/2025-04-01/company-data/extractShareholderGraph.md): Extract multi-level shareholder graph for a company.
- [Extract Ultimate Beneficial Owners](https://docs.kausate.com/api-reference/2025-04-01/company-data/extractUBOs.md): Extract Ultimate Beneficial Owners from official registers.
- [Get Company Report Run](https://docs.kausate.com/api-reference/2025-04-01/company-data/getCompanyReportRun.md): Retrieve typed status for a company report run.
- [Get Shareholder Graph Run](https://docs.kausate.com/api-reference/2025-04-01/company-data/getShareholderGraphRun.md): Retrieve typed status for a shareholder graph run.
- [Get UBO Run](https://docs.kausate.com/api-reference/2025-04-01/company-data/getUBORun.md): Retrieve typed status for a UBO extraction run.
- [Retrieve Company Report](https://docs.kausate.com/api-reference/2025-04-01/company-data/orderReport.md): Retrieve a structured company report from official registries.
- [Publish Shareholder Graph](https://docs.kausate.com/api-reference/2025-04-01/company-data/publishShareholderGraph.md): Publish a completed shareholder-graph order behind an unguessable public URL.

The returned `publicUrl` renders the same UBO studio visualization as the
authenticated app. The slug is a capability token — anyone holding it can
view the graph, so treat it like a secret.
- [Get Document Run](https://docs.kausate.com/api-reference/2025-04-01/documents/getDocumentRun.md): Retrieve typed status for a document retrieval run.
- [Get List Documents Run](https://docs.kausate.com/api-reference/2025-04-01/documents/getListDocumentsRun.md): Retrieve typed status for a list-documents run.
- [List Available Documents](https://docs.kausate.com/api-reference/2025-04-01/documents/listDocuments.md): List all available documents for a company from their business registry.
- [Retrieve Company Document](https://docs.kausate.com/api-reference/2025-04-01/documents/retrieveDocument.md): Retrieve a company document from official registries.
- [Get Financials Run](https://docs.kausate.com/api-reference/2025-04-01/financials/getFinancialsRun.md): Retrieve typed status for a financial statements run.
- [Retrieve Financials](https://docs.kausate.com/api-reference/2025-04-01/financials/orderFinancials.md): Retrieve structured financial statements (balance sheet, income statement, cash flow) from official registries.
- [Create Integration](https://docs.kausate.com/api-reference/2025-04-01/integrations/createIntegration.md): Create a new integration for external data sources.
- [Delete Integration](https://docs.kausate.com/api-reference/2025-04-01/integrations/deleteIntegration.md): Delete an integration.
- [List Integrations](https://docs.kausate.com/api-reference/2025-04-01/integrations/listIntegrations.md): List all integrations for your organization.
- [Update Integration](https://docs.kausate.com/api-reference/2025-04-01/integrations/updateIntegration.md): Update an existing integration's credentials.
- [List Jurisdiction Capabilities](https://docs.kausate.com/api-reference/2025-04-01/jurisdictions/listJurisdictionCapabilities.md): List all jurisdictions with capability statuses and available document types.
- [Create a new monitor](https://docs.kausate.com/api-reference/2025-04-01/monitors/createMonitor.md): Create a new monitor for tracking changes to a company.
- [Delete a monitor](https://docs.kausate.com/api-reference/2025-04-01/monitors/deleteMonitor.md): Delete a monitor.
- [Get monitor details](https://docs.kausate.com/api-reference/2025-04-01/monitors/getMonitor.md): Get detailed information about a specific monitor.
- [List all monitors](https://docs.kausate.com/api-reference/2025-04-01/monitors/listMonitors.md): List all monitors for the authenticated organization.
- [Prefill Company Data](https://docs.kausate.com/api-reference/2025-04-01/prefill/prefillCompany.md): Get company report data for form prefilling (indexed with real-time fallback).
- [Autocomplete Companies (indexed)](https://docs.kausate.com/api-reference/2025-04-01/search/autocompleteCompanies.md): Fast type-ahead suggestions for company names. Returns up to 50 matching companies based on name prefix.
- [Get Live Search Run](https://docs.kausate.com/api-reference/2025-04-01/search/getLiveSearchRun.md): Retrieve typed status for a live-search run.
- [Search Companies](https://docs.kausate.com/api-reference/2025-04-01/search/liveSearchCompanies.md): Search for companies in real-time from official business registries. Returns results with Kausate IDs.
- [Create Webhook](https://docs.kausate.com/api-reference/2025-04-01/webhooks/createWebhook.md): Create a new webhook for the organization
- [Delete Webhook](https://docs.kausate.com/api-reference/2025-04-01/webhooks/deleteWebhook.md): Delete a webhook
- [Get Webhook](https://docs.kausate.com/api-reference/2025-04-01/webhooks/getWebhook.md): Get a specific webhook
- [List Webhooks](https://docs.kausate.com/api-reference/2025-04-01/webhooks/listWebhooks.md): List all webhooks for the organization
- [Update Webhook](https://docs.kausate.com/api-reference/2025-04-01/webhooks/updateWebhook.md): Update a webhook
- [Async & Sync Processing](https://docs.kausate.com/api-reference/async-sync.md): How Kausate handles async and sync data retrieval from government registries
- [Extract Shareholder Graph](https://docs.kausate.com/api-reference/company-data/extractShareholderGraph.md): Extract multi-level shareholder graph for a company. Poll GET /v2/companies/shareholder-graph/{orderId} or subscribe via webhook.
- [Extract Shareholder Graph (sync)](https://docs.kausate.com/api-reference/company-data/extractShareholderGraphSync.md): Extract a shareholder graph synchronously. Blocks for up to 300 seconds.

Only `maxDepth=1` is supported for sync requests — deeper graphs exceed the
300s budget. Requests with `maxDepth>1` are rejected with 400; use the async
`POST /v2/companies/shareholder-graph` endpoint for multi-level extraction.
- [Extract Ultimate Beneficial Owners](https://docs.kausate.com/api-reference/company-data/extractUBOs.md): Place an order to extract Ultimate Beneficial Owners. Poll GET /v2/companies/ubo/{orderId} or subscribe via webhook.
- [Extract Ultimate Beneficial Owners (sync)](https://docs.kausate.com/api-reference/company-data/extractUBOsSync.md): Extract Ultimate Beneficial Owners synchronously. Blocks for up to 300 seconds.
- [Get Company Report Run](https://docs.kausate.com/api-reference/company-data/getCompanyReportRun.md): Retrieve typed status for a company report run.
- [Get Shareholder Graph Run](https://docs.kausate.com/api-reference/company-data/getShareholderGraphRun.md): Retrieve typed status for a shareholder graph run.
- [Get UBO Run](https://docs.kausate.com/api-reference/company-data/getUBORun.md): Retrieve typed status for a UBO extraction run.
- [Retrieve Company Report](https://docs.kausate.com/api-reference/company-data/orderReport.md): Place an order for a structured company report. Poll GET /v2/companies/report/{orderId} or subscribe via webhook.
- [Retrieve Company Report (sync)](https://docs.kausate.com/api-reference/company-data/orderReportSync.md): Retrieve a company report synchronously. Blocks for up to 300 seconds.
- [Publish Shareholder Graph](https://docs.kausate.com/api-reference/company-data/publishShareholderGraph.md): Publish a completed shareholder-graph order behind an unguessable public URL.

The returned `publicUrl` renders the same UBO studio visualization as the
authenticated app. The slug is a capability token — anyone holding it can
view the graph, so treat it like a secret.
- [Get Document Run](https://docs.kausate.com/api-reference/documents/getDocumentRun.md): Retrieve typed status for a document retrieval run.
- [Get List Documents Run](https://docs.kausate.com/api-reference/documents/getListDocumentsRun.md): Retrieve typed status for a list-documents run.
- [List Available Documents](https://docs.kausate.com/api-reference/documents/listDocuments.md): Place an order to list documents available for a company. Poll GET /v2/companies/documents/list/{orderId} or subscribe via webhook.
- [List Available Documents (sync)](https://docs.kausate.com/api-reference/documents/listDocumentsSync.md): List all available documents for a company synchronously. Blocks for up to 300 seconds.
- [Retrieve Company Document](https://docs.kausate.com/api-reference/documents/retrieveDocument.md): Place a document retrieval order. Poll GET /v2/companies/documents/{orderId} or subscribe via webhook.
- [Retrieve Company Document (sync)](https://docs.kausate.com/api-reference/documents/retrieveDocumentSync.md): Retrieve a company document synchronously. Blocks for up to 300 seconds.
- [Get Financials Run](https://docs.kausate.com/api-reference/financials/getFinancialsRun.md): Retrieve typed status for a financial statements run.
- [Retrieve Financials](https://docs.kausate.com/api-reference/financials/orderFinancials.md): Place an order for structured financial statements. Poll GET /v2/companies/finance/{orderId} or subscribe via webhook.
- [Retrieve Financials (sync)](https://docs.kausate.com/api-reference/financials/orderFinancialsSync.md): Retrieve structured financial statements synchronously. Blocks for up to 300 seconds.
- [Create Integration](https://docs.kausate.com/api-reference/integrations/createIntegration.md): Create a new integration for external data sources.
- [Delete Integration](https://docs.kausate.com/api-reference/integrations/deleteIntegration.md): Delete an integration.
- [List Integrations](https://docs.kausate.com/api-reference/integrations/listIntegrations.md): List all integrations for your organization.
- [Update Integration](https://docs.kausate.com/api-reference/integrations/updateIntegration.md): Update an existing integration's credentials.
- [List Jurisdiction Capabilities](https://docs.kausate.com/api-reference/jurisdictions/listJurisdictionCapabilities.md): List all jurisdictions with capability statuses and available document types.
- [Company Monitoring](https://docs.kausate.com/api-reference/monitors.md): Track changes to company data over time and receive webhook notifications when something changes.
- [Create a new monitor](https://docs.kausate.com/api-reference/monitors/createMonitor.md): Create a new monitor for tracking changes to a company.
- [Delete a monitor](https://docs.kausate.com/api-reference/monitors/deleteMonitor.md): Delete a monitor.
- [Get monitor details](https://docs.kausate.com/api-reference/monitors/getMonitor.md): Get detailed information about a specific monitor.
- [List all monitors](https://docs.kausate.com/api-reference/monitors/listMonitors.md): List all monitors for the authenticated organization.
- [Prefill Company Data](https://docs.kausate.com/api-reference/prefill/prefillCompany.md): Get company report data for form prefilling (indexed with real-time fallback).
- [Autocomplete Companies (indexed)](https://docs.kausate.com/api-reference/search/autocompleteCompanies.md): Fast type-ahead suggestions for company names. Returns up to 50 matching companies based on name prefix.
- [Get Live Search Run](https://docs.kausate.com/api-reference/search/getLiveSearchRun.md): Retrieve typed status for a live-search run.
- [Search Companies](https://docs.kausate.com/api-reference/search/liveSearchCompanies.md): Place a live company search order against official business registries.
- [Search Companies (sync)](https://docs.kausate.com/api-reference/search/liveSearchCompaniesSync.md): Search for companies synchronously. Blocks for up to 300 seconds.
- [Create Webhook](https://docs.kausate.com/api-reference/webhooks/createWebhook.md): Create a new webhook for the organization
- [Delete Webhook](https://docs.kausate.com/api-reference/webhooks/deleteWebhook.md): Delete a webhook
- [Get Webhook](https://docs.kausate.com/api-reference/webhooks/getWebhook.md): Get a specific webhook
- [List Webhooks](https://docs.kausate.com/api-reference/webhooks/listWebhooks.md): List all webhooks for the organization
- [Update Webhook](https://docs.kausate.com/api-reference/webhooks/updateWebhook.md): Update a webhook

## Changelog

- [Changelog](https://docs.kausate.com/changelog.md): Recent updates and improvements to the Kausate API

## Getting Started

- [Getting Started](https://docs.kausate.com/getting-started.md): End-to-end guide for retrieving German company data

## Guides

- [Firmenbuch API](https://docs.kausate.com/guides/integrations/at-firmenbuch.md): Austrian commercial register (Firmenbuch) integration for company data and documents
- [KBO API](https://docs.kausate.com/guides/integrations/be-kbo.md): Belgian Crossroads Bank for Enterprises (KBO/BCE) integration
- [Zefix API](https://docs.kausate.com/guides/integrations/ch-zefix.md): Swiss Central Business Name Index (Zefix) integration
- [Handelsregister API](https://docs.kausate.com/guides/integrations/de-handelsregister.md): Documentation for the Handelsregister API, including real-time document retrieval and organization data access
- [Transparenzregister API](https://docs.kausate.com/guides/integrations/de-transparenzregister.md): German transparency register for beneficial ownership data
- [Unternehmensregister API](https://docs.kausate.com/guides/integrations/de-unternehmensregister.md): German company register portal for publications and filings
- [Registro Mercantil API](https://docs.kausate.com/guides/integrations/es-registro-mercantil.md): Spanish Commercial Register integration for company data and filings
- [PRH Trade Register API](https://docs.kausate.com/guides/integrations/fi-prh.md): Finnish Patent and Registration Office integration for company data
- [Infogreffe API](https://docs.kausate.com/guides/integrations/fr-infogreffe.md): French Commercial Courts platform integration for company data and documents
- [INPI API](https://docs.kausate.com/guides/integrations/fr-inpi.md): French National Institute of Industrial Property (INPI) company data
- [Companies House API](https://docs.kausate.com/guides/integrations/gb-companies-house.md): UK Companies House integration for company data and filings
- [CRO API](https://docs.kausate.com/guides/integrations/ie-cro.md): Irish Companies Registration Office integration
- [Registro Imprese API](https://docs.kausate.com/guides/integrations/it-registro-imprese.md): Italian Business Register integration
- [Luxembourg Business Registers API](https://docs.kausate.com/guides/integrations/lu-lbr.md): Luxembourg RCS integration for company data and filings
- [KVK API](https://docs.kausate.com/guides/integrations/nl-kvk.md): Dutch Chamber of Commerce (Kamer van Koophandel) integration
- [Brønnøysund Register Centre API](https://docs.kausate.com/guides/integrations/no-brreg.md): Norwegian business register integration for company data
- [Krajowy Rejestr Sądowy API](https://docs.kausate.com/guides/integrations/pl-krs.md): Polish National Court Register integration for company data
- [Registo Comercial API](https://docs.kausate.com/guides/integrations/pt-registo-comercial.md): Portuguese Commercial Register integration for company data
- [Bolagsverket API](https://docs.kausate.com/guides/integrations/se-bolagsverket.md): Swedish Companies Registration Office integration for company data
- [Austria (AT)](https://docs.kausate.com/guides/jurisdictions/austria.md): Overview of Austrian company data coverage, registers, and legal forms
- [Belgium (BE)](https://docs.kausate.com/guides/jurisdictions/belgium.md): Overview of Belgian company data coverage, registers, and legal forms
- [Finland (FI)](https://docs.kausate.com/guides/jurisdictions/finland.md): Overview of Finnish company data coverage, registers, and legal forms
- [France (FR)](https://docs.kausate.com/guides/jurisdictions/france.md): Overview of French company data coverage, registers, and legal forms
- [Germany (DE)](https://docs.kausate.com/guides/jurisdictions/germany.md): Overview of German company data coverage, registers, and legal forms
- [Ireland (IE)](https://docs.kausate.com/guides/jurisdictions/ireland.md): Overview of Irish company data coverage, registers, and legal forms
- [Italy (IT)](https://docs.kausate.com/guides/jurisdictions/italy.md): Overview of Italian company data coverage, registers, and legal forms
- [Luxembourg (LU)](https://docs.kausate.com/guides/jurisdictions/luxembourg.md): Overview of Luxembourg company data coverage, registers, and legal forms
- [Netherlands (NL)](https://docs.kausate.com/guides/jurisdictions/netherlands.md): Overview of Dutch company data coverage, registers, and legal forms
- [Norway (NO)](https://docs.kausate.com/guides/jurisdictions/norway.md): Overview of Norwegian company data coverage, registers, and legal forms
- [Poland (PL)](https://docs.kausate.com/guides/jurisdictions/poland.md): Overview of Polish company data coverage, registers, and legal forms
- [Portugal (PT)](https://docs.kausate.com/guides/jurisdictions/portugal.md): Overview of Portuguese company data coverage, registers, and legal forms
- [Spain (ES)](https://docs.kausate.com/guides/jurisdictions/spain.md): Overview of Spanish company data coverage, registers, and legal forms
- [Sweden (SE)](https://docs.kausate.com/guides/jurisdictions/sweden.md): Overview of Swedish company data coverage, registers, and legal forms
- [Switzerland (CH)](https://docs.kausate.com/guides/jurisdictions/switzerland.md): Overview of Swiss company data coverage, registers, and legal forms
- [United Kingdom (GB)](https://docs.kausate.com/guides/jurisdictions/united-kingdom.md): Overview of UK company data coverage, registers, and legal forms