List Available Documents (real-time)

curl --request POST \
  --url https://api.kausate.com/v2/companies/{kausateId}/documents/list \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "customerReference": "<string>"
}
'

{
  "kausateId": "co_de_D2601V_HRB82381",
  "documents": [
    {
      "kausateDocumentId": "doc_de_abc123def456",
      "title": "Jahresabschluss zum Geschäftsjahr vom 01.01.2024 bis zum 31.12.2024",
      "documentType": "annualAccounts",
      "publicationType": "Jahresabschluss",
      "publicationDate": "2025-08-19",
      "source": "Unternehmensregister",
      "hasPdf": true,
      "language": "de"
    }
  ],
  "totalCount": 115,
  "cachedAt": "2025-11-25T22:00:00Z",
  "expiresAt": "2025-11-26T22:00:00Z"
}

Companies

List Available Documents (real-time)

List all available documents for a company from their business registry.

Supported Jurisdictions:

Germany (DE): Documents from Unternehmensregister (annual accounts, board changes, register announcements, etc.)
Austria (AT): Documents from Austrian Firmenbuch (Jahresabschluss, Lagebericht, Gesellschaftsvertrag, etc.)

The document list is cached for 24 hours.

This endpoint is FREE - no credits are consumed.

Typical workflow:

Use GET /v2/companies/search/indexed?name=...&jurisdictionCode=de to find the company
Call this endpoint to get the list of available documents
Use the returned kausateDocumentId with POST /v2/companies/{kausateId}/products/order (pass kausateDocumentId in the request body) to download a specific document (costs credits)

Parameters:

kausateId: Company ID (DE or AT jurisdiction)
customerReference: Optional reference for tracking
sync: If True (default), wait for results. If False, return workflow ID immediately

Returns:

If sync=True: List of available documents with their kausateDocumentIds
If sync=False: Workflow information for async tracking

Note: Document IDs are cached for 24 hours. After expiration, you’ll need to call this endpoint again to get fresh document IDs.

POST

companies

{kausateId}

documents

list

List Available Documents (real-time)

curl --request POST \
  --url https://api.kausate.com/v2/companies/{kausateId}/documents/list \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "customerReference": "<string>"
}
'

{
  "kausateId": "co_de_D2601V_HRB82381",
  "documents": [
    {
      "kausateDocumentId": "doc_de_abc123def456",
      "title": "Jahresabschluss zum Geschäftsjahr vom 01.01.2024 bis zum 31.12.2024",
      "documentType": "annualAccounts",
      "publicationType": "Jahresabschluss",
      "publicationDate": "2025-08-19",
      "source": "Unternehmensregister",
      "hasPdf": true,
      "language": "de"
    }
  ],
  "totalCount": 115,
  "cachedAt": "2025-11-25T22:00:00Z",
  "expiresAt": "2025-11-26T22:00:00Z"
}

Authorizations

X-API-Key

string

header

required

Headers

X-Partner-Customer-Id

string | null

Optional partner customer ID

Path Parameters

kausateId

string

required

Company ID

Query Parameters

sync

boolean

default:true

Return result synchronously (default: true)

Body

application/json

Request model for listing available documents for a company.

customerReference

string | null

Maximum string length: 150

Response

Document listing completed successfully

ProductOrderResponse
ListDocumentsResponse

Response model for product order.

orderId

string

required

customerReference

string | null

Maximum string length: 150

partnerCustomerId

string | null

Maximum string length: 150

Extract Ultimate Beneficial Owners (real-time)List Orders

⌘I

Getting Started

Integration

API Reference

List Available Documents (real-time)

Authorizations

Headers

Path Parameters

Query Parameters

Body

Response