Not every registered entity has shareholders, and not every entity has a board. Topograph applies one consistent convention across all countries for the two entity families where the standard company data model doesn’t map one-to-one: sole entrepreneurs (natural-person businesses) and non-profits (associations, foundations, and similar forms).
This page describes exactly what each datapoint returns for these entity types, so you don’t need entity-type-specific business rules on your side.
Sole entrepreneurs
A sole entrepreneur (French entrepreneur individuel, German eingetragener Kaufmann, Bulgarian едноличен търговец (ЕТ), Italian ditta individuale, Greek ατομική επιχείρηση, Ukrainian ФОП, and equivalents) is a natural person doing business without a separate legal personality. There is no share capital, no equity instrument, and no shareholder register anywhere.
The datapoint_not_applicable response
Requesting shareholders for a sole entrepreneur does not fail silently and does not return a misleading empty array. The datapoint completes as failed with a dedicated, machine-readable error code:
Key properties:
- It is not a fault. The code is a definitive answer derived from the entity’s legal form, not a register outage. Do not retry.
- You are not charged when
shareholders is the only datapoint of its billing block in the request: the block is automatically refunded like any other unfulfilled datapoint. When shareholders shares a block with datapoints that did deliver (for example company), the block is billed once, as usual.
- The ownership answer still exists: read it from
legalRepresentatives and ultimateBeneficialOwners instead.
If your pipeline iterates all datapoints uniformly, branch on error.code === "datapoint_not_applicable" to skip the ownership module for these entities, or simply rely on ultimateBeneficialOwners, which answers “who owns this business” for every entity type, including sole entrepreneurs.
Non-profits
Associations, foundations, and similar non-profit forms (French association loi 1901, German e.V., Irish CLGs, and equivalents) have members and boards, not shareholders.
Coverage notes
- Some countries structurally cannot serve sole entrepreneurs because no public register holds them (for example UK sole traders, or Hong Kong sole proprietorships, which live outside the companies register). Those return
resource_not_found: a coverage fact, not an entity-type rule. Country-level coverage is on each country guide.
- The rollout of the explicit
datapoint_not_applicable response is per-country. Countries not yet converted may still return an empty shareholders array for these entity types; treat an empty array for a Sole Proprietorship legal form the same way you would treat the explicit code.
Related pages