Retrieve Financials

Place an order for structured financial statements. Poll GET /v2/companies/finance/{orderId} or subscribe via webhook.

Authorization

api_key

X-API-Key<token>

In: header

Query Parameters

batch?boolean

Mark as a batch/backfill request. Batch requests run at lowest priority to avoid blocking interactive queries.

Defaultfalse

Header Parameters

Kausate-Version?string

Default"2026-05-01"

Formatdate

X-Customer-Id?|

Optional customer ID

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

customerReference?|

bypassCache?boolean

If true, bypass daily deduplication and force a fresh request.

Defaultfalse

kausateId*string

Kausate universal company identifier (format: co_{jurisdiction}_{id})

Match^co_([a-z]{2}|[a-z]{2}-[a-z]{2})_[a-zA-Z0-9]+$

Length1 <= length

Response Body

`application/json`

curl -X POST "https://api.kausate.com/v2/companies/finance" \  -H "Kausate-Version: 2026-05-01" \  -H "Content-Type: application/json" \  -d '{    "kausateId": "string"  }'

{
  "orderId": "co_nl_12345678-financials-org_123-20260318",
  "customerReference": "my-ref-123"
}

{
  "detail": "Invalid company ID format"
}

{
  "detail": "Invalid API key"
}

{
  "detail": "Insufficient credits. Required: 10, Available: 5"
}

{
  "detail": "Company not found"
}

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string",
      "input": null,
      "ctx": {}
    }
  ]
}

{
  "detail": "An internal error occurred"
}

Authorization

Query Parameters

Header Parameters

Request Body

Response Body

200application/json

400application/json

401application/json

403application/json

404application/json

422application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`