Company Documents
List Available Documents (real-time)
List all available documents for a company from their business registry.
Authorization
api_key X-API-Key<token>
Sign up at Kausate.com to get an API key
In: header
Path Parameters
kausateId*string
Query Parameters
sync?boolean
Return result synchronously (default: true). Note: government registries may be slow or unavailable; async mode with webhooks is more reliable for production use.
Default
trueHeader Parameters
X-Partner-Customer-Id?|
Optional partner customer ID
Request Body
application/json
customerReference?|
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://api.kausate.com/v2/companies/string/documents/list" \ -H "Content-Type: application/json" \ -d '{}'{
"orderId": "co_de_4JFFrsbQ99t1nmRw2JgzmG-list-docs-de-20251125220000",
"customerReference": "my-ref-123",
"status": "completed",
"requestTime": "2025-11-25T22:00:00Z",
"responseTime": "2025-11-25T22:00:05Z",
"result": {
"kausateId": "co_de_4JFFrsbQ99t1nmRw2JgzmG",
"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"
}
],
"totalCount": 115,
"cachedAt": "2025-11-25T22:00:00Z",
"expiresAt": "2025-11-26T22:00:00Z"
}
}{
"detail": "Invalid company ID format"
}{
"detail": "Invalid API key"
}{
"detail": "Company not found"
}{
"detail": [
{
"loc": [
"string"
],
"msg": "string",
"type": "string"
}
]
}{
"detail": "An internal error occurred"
}Last updated on