Datasets
Download a data source's companies as a file to search and prefill from your own systems.
Datasets deliver the companies of a data source as files, for teams that run company search or form prefill inside their own infrastructure. Each dataset is a monthly subscription item of its own; a dataset your subscription does not include returns HTTP 403, and the list of all datasets shows only those you subscribe to.
Available datasets
| Data source | datasetType | One record per company | Published |
|---|---|---|---|
de-handelsregister | index | The company search record, plus legal form and incorporation date | Daily |
de-handelsregister | reports | The company report: basic information, legal representatives and related data | Monthly |
Every file is a complete snapshot, not a delta. Replace your copy with the newest file. The seven most recent files of each dataset stay available.
Download the latest file
Request the latest dataset, then follow its downloadUrl. datasetType defaults
to reports.
curl --fail --get "https://api.kausate.com/v2/datasets/de-handelsregister/latest" \
--data-urlencode "datasetType=index" \
-H "X-API-Key: ${API_KEY}"{
"downloadUrl": "https://api.kausate.com/documents/…/download",
"fileSizeBytes": 262144000,
"recordCount": 3050000,
"jsonlSizeBytes": 1887436800
}curl --fail --location "${DOWNLOAD_URL}" --output index.jsonl.zipThe file is a ZIP archive holding one UTF-8 JSON Lines file. recordCount is the
number of lines; compare it after loading to confirm the import is complete.
List datasets returns earlier files
with their datasetDate.
Index records
One line per company in the index:
{
"kausateId": "co_de_7luoMHZuHSTFqZfKkAF7Dr",
"name": "Sinpex GmbH",
"alternativeNames": null,
"status": {
"isActive": true,
"original": "currently registered",
"normalized": "active"
},
"identifiers": [
{
"type": "de_registernumber_full",
"value": "D2601_HRB258620",
"extra": { "districtCourt": "München" },
"source": "de-handelsregister",
"jurisdiction": "de"
},
{
"type": "de_registernumber_weak",
"value": "HRB 258620",
"extra": { "districtCourt": "München" },
"source": "de-handelsregister",
"jurisdiction": "de"
}
],
"addresses": [
{
"type": "registered",
"original": "München",
"normalized": { "city": "München" }
}
],
"legalForm": {
"original": "GmbH",
"normalized": "Gesellschaft mit beschränkter Haftung",
"category": "LLC",
"iso20275LegalFormCode": "2HBR"
},
"incorporationDate": { "original": "19.7.2019", "normalized": "2019-07-19" },
"firstIndexed": "2025-10-03T00:31:38.512730+00:00",
"lastIndexed": "2026-10-12T00:26:38.096086+00:00"
}| Field | Meaning |
|---|---|
kausateId | Stable company identifier. Use it as your primary key and for every follow-up API request. |
name, alternativeNames | Registered name, and former or alternative names when known. |
status | Register status in the register's wording and normalized. |
identifiers | Register number with register type, and the register court as name (extra.districtCourt) and as court code prefix. |
addresses | Registered seat, and the business address when known. |
legalForm, incorporationDate | Taken from the company report. null until a report exists, which is typical for newly registered companies. |
firstIndexed, lastIndexed | When the company first appeared in the index and when its record was last confirmed against the register. |
kausateId, name, identifiers, addresses and status have the same shape
as in company search.
Report records
One line per company with a report:
{ "kausateId": "co_de_…", "retrievalTime": "2026-09-06T08:29:23+00:00", "companyReport": { … } }companyReport is the company report returned by the API, without its sources;
fields without a value are left out. retrievalTime is when the report was read
from the register.
Last updated on