Company data model
Read a company report, trace data to its sources and distinguish company, registry and order identifiers.
Search returns a kausateId for a matching company. Use it to request a
report, which can include the company's registered name, status, addresses
and relationships. See Quickstart for a full example.
Company report
The completed order contains the report at result.companyReport. The tables
below describe fields in the current API version. Use the
API Reference and its version selector when integrating
against an earlier version.
| Field | Type | Required | Description |
|---|---|---|---|
sources | map of ReportSource | Yes | |
risk | EntityRisk or null | No | |
basicInformation | BasicInformation or null | No | |
relationships | Relationships or null | No | |
errors | array of CompanyReportError | No | Non-fatal data errors in this report. The report remains usable; each entry's path identifies the unavailable field. |
A report's coverage depends on the company, its jurisdiction and the sections
requested. Handle both omitted fields and null where the schema allows
them. Read errors for non-fatal data errors. Each error's path points to a
field within companyReport and its code identifies the issue. Keep usable
fields and handle those errors separately. See Errors
for details.
Basic information
This section describes the company itself. A status summarizes its legal state, while status events describe individual changes or proceedings. A legal form describes the type of entity, such as a limited company. Normalized values explains each status and legal form category.
| Field | Type | Required | Description |
|---|---|---|---|
type | "organization" or null | No | |
legalName | string or null | No | |
alternativeNames | array of AlternativeName or null | No | |
status | Status or null | No | |
statusEvents | array of CompanyStatusEvent or null | No | Registered lifecycle events the registry states in prose — insolvency orders, provisional measures, dissolutions, extinctions, continuations — with the wording and source location each was read from. Present where the registry publishes them; status is the state they add up to. |
legalForm | LegalForm or null | No | |
representationPolicy | RepresentationPolicy or null | No | |
capital | Capital or null | No | |
identifiers | array of Identifier or null | No | |
dates | Dates or null | No | |
addresses | array of Address or null | No | Addresses associated with the reported company. Company address purposes generally include registered (registration), business (business premises), mailing (correspondence), physical (physical presence), and operations (operating location, possibly only a locality). Types depend on the registry; the shared AddressType enum is not a field-specific allowlist. Representative addresses are carried on their person or company records in relationships.legalRepresentatives. See https://docs.kausate.com/features/addresses for all types and mapping guidance. |
activities | array of Activity or null | No | |
contacts | array of ContactInfo or null | No | |
employeeCount | EmployeeCount or null | No | |
bankAccounts | array of BankAccount or null | No |
Relationships
This section describes people and companies connected to the subject. Legal representatives can act for the company in a stated role. Shareholders hold an interest in the company and subsidiaries are companies in which it holds an interest. Normalized values explains each role.
| Field | Type | Required | Description |
|---|---|---|---|
legalRepresentatives | array of LegalRepresentative or null | No | |
branches | array of Company or null | No | |
shareholders | array of Shareholder or null | No | |
subsidiaries | array of Subsidiary or null | No | Companies this company holds an equity stake in, as of each entry's asOf date. Present only when the subsidiaries dataSection was requested and the jurisdiction supplies it. |
ownershipIncompleteReason | IncompleteOwnershipReason or null | No | Set when the register publishes only part of the company's shareholdings, so shareholders may add up to less than 100%. Absent when the list is the register's complete cap table. |
contractualInterests | array of ContractualInterest or null | No | |
legalPredecessors | array of LegalSuccession or null | No | Companies whose legal rights and obligations this company took over, in whole or in part, by a merger or demerger. |
legalSuccessors | array of LegalSuccession or null | No | Companies that took over this company's legal rights and obligations, in whole or in part, by a merger or demerger. |
Glossary
| Term | Meaning |
|---|---|
| Jurisdiction | The country, territory or subdivision in which the company is registered. API requests use a jurisdiction code such as de. |
kausateId | The opaque company identifier returned by search and accepted by company endpoints. Store and reuse the complete value. |
| Registry identifier | A number or code issued by a registration authority. Interpret it with its type and jurisdiction. One company can have several identifiers. |
| Source | An entry in the report's sources map describing where a piece of data comes from. A field's source reference can point back to an entry in that report. |
| Normalized value | A Kausate value shared across jurisdictions, such as a status or legal form category, for use in comparisons or rules. Where both are supplied, the reported wording provides local detail. |
orderId | The Kausate identifier for a specific order. Use it to retrieve the result or correlate a webhook delivery. |
customerReference | An optional reference from your system for matching an order to your records. See Authentication. |
Last updated on