Retrieve Company Document
Retrieve a company document from official registries.
Authorization
api_key Sign up at Kausate.com to get an API key
In: header
Path Parameters
Query Parameters
Return result synchronously with 300s timeout. Not recommended: government registries are unreliable and timeouts are common. Use default async mode with webhooks (recommended) or polling using the orderId instead.
falseHeader Parameters
Optional partner customer ID
Request Body
application/json
Product SKU code (e.g., DEHRAD, DEHRSI). Required if kausateDocumentId not provided.
Document ID from /documents/list response (e.g., doc_deur_abc123). Required if sku not provided.
Output format. 'pdf' converts TIFF files to PDF (default). 'raw' keeps original format.
"raw""pdf" | "raw"If true, bypass daily deduplication and force a fresh request.
falseResponse Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://api.kausate.com/v2/companies/string/documents/" \ -H "Content-Type: application/json" \ -d '{}'{
"orderId": "order-co_de_4JFFrsbQ99t1nmRw2JgzmG-DEHRAD-20240319143022",
"customerReference": "doc-order-123",
"partnerCustomerId": "partner-berlin-001"
}{
"detail": "Invalid company ID format"
}{
"detail": "Invalid API key"
}{
"detail": "Insufficient credits. Required: 10, Available: 5"
}{
"detail": "Company not found"
}{
"detail": "Request timed out after 300 seconds. The workflow may still be running in the background."
}{
"detail": [
{
"loc": [
"string"
],
"msg": "string",
"type": "string"
}
]
}{
"detail": "An internal error occurred"
}Last updated on