Documents
List a company's filed documents, order one by shortcut, product code or document ID, and download the file.
A document order delivers a registry document for one company, such as a register extract, articles of association or annual accounts. It has three steps: list what is available, order a document, and download the file.
List available documents
POST /v2/companies/documents/list takes a kausateId and returns the
documents filed for that company. Listing is free.
curl -X POST https://api.kausate.com/v2/companies/documents/list/sync \
-H "X-API-Key: $API_KEY" \
-H "Kausate-Version: 2026-08-01" \
-H "Content-Type: application/json" \
-d '{"kausateId": "co_de_7aH2IUvdvC6XGzbUbSyhOU"}'The completed order holds result.documents and result.totalCount. Each
document has:
| Field | Meaning |
|---|---|
kausateDocumentId | The ID to order this exact document with. |
title | The document's title as the register publishes it. |
documentType | A category shared across jurisdictions, such as annualAccounts, where known. |
publicationType | The register's own kind of filing, where given. |
publicationDate | When the document was published or filed. Some registers give only the year. |
fileType | The file format, such as pdf. |
Order a document
POST /v2/companies/documents takes a kausateId and exactly one of sku
or kausateDocumentId. There are three ways to name the document:
| Order by | Send | Use when |
|---|---|---|
| A shortcut | sku: a shortcut, register_extract | You want the same kind of document in every jurisdiction. |
| A product code | sku: a code from the jurisdiction guide | The jurisdiction has several variants and you want a specific one. |
| A listed document | kausateDocumentId from the list | You picked a specific filing, such as last year's accounts. |
curl -X POST https://api.kausate.com/v2/companies/documents/sync \
-H "X-API-Key: $API_KEY" \
-H "Kausate-Version: 2026-08-01" \
-H "Content-Type: application/json" \
-d '{"kausateId": "co_de_7aH2IUvdvC6XGzbUbSyhOU", "sku": "register_extract"}'Signed-in customers find each jurisdiction's documents, with their product
codes and shortcuts, in its jurisdiction guide and in the
document catalogue, which lists every product on one
page. A document marked as needing a document ID can only be ordered by
kausateDocumentId: list the company's documents first.
The asynchronous POST /v2/companies/documents returns an orderId to poll
with Get Document Order or to match
to a webhook delivery. See
Requests: sync & async.
Download the file
The completed order holds result.downloadLink. fileName and contentType
describe the file where they are known; otherwise take them from the download
response. Download the file from that link:
curl --fail --location "$DOWNLOAD_LINK" --output "$FILE_NAME"The link needs no API key: anyone who has it can download the document, so
share it only with the people who need the file. Add convertPdf=true to
receive one PDF for an HTML original or a ZIP of PDFs. See
Document downloads.
Document shortcuts
A shortcut names a kind of document independently of the jurisdiction. Kausate orders the jurisdiction's matching document.
| Shortcut | Document |
|---|---|
annual_accounts | Annual accounts / financial statements as filed with the commercial register (e.g. Jaarrekening, Comptes annuels, Årsredovisning, Bilancio). |
financial_statements | Financial statements PDF as filed with the dedicated balance-sheet authority (e.g. NBB CBSO in Belgium) — the authoritative source dossier including balance sheet, P&L, notes, and auditor's report. |
articles_of_association | Founding document describing the rules and structure of the company (e.g. Articles of Association, Satzung, Gesellschaftsvertrag, Statuts, yhtiöjärjestys). |
register_extract | Current-state extract from the commercial register. This generic shortcut may resolve to either a registry-issued document or a Kausate-generated summary. |
register_extract_official | Current-state extract issued by the registry, including certified, signed, sealed, or uncertified registry PDFs. Excludes Kausate-generated summaries. |
historical_register_extract | Full / chronological extract from the commercial register including the company's historical entries (e.g. former names, past directors, capital changes), not just the current registered state. |
shareholders_list | List of the company's current shareholders and their holdings. |
ubo_extract | Extract from the UBO / beneficial-ownership register listing the company's ultimate beneficial owners. |
Use register_extract_official when you need the document as the register
issued it.
Which shortcuts each jurisdiction serves, and the document each one orders there, is in the document catalogue once you sign in.
Last updated on