How each datapoint behaves for natural-person businesses and non-profit entities
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.
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.
Datapoint
Behavior
company
Returned normally. legalForm.standardized is Sole Proprietorship, so you can recognize the entity type from the response.
legalRepresentatives
Always the person. The owner is returned as the legal representative with the identity fields the register publishes (name, and where available date of birth, address, nationality). This is the record you need for sanctions/PEP screening.
ultimateBeneficialOwners
The person, at 100%. AML frameworks deem the sole trader the beneficial owner of the business, so where the country exposes a UBO datapoint, the owner is returned with 100% direct ownership, even when no separate UBO declaration exists in the register. Exception: in countries where beneficial owners come from an official certificate obtained manually (Croatia, Cyprus, Germany without your own register access, Ireland, Portugal, Slovakia, Slovenia, China), a sole trader has no certificate, so the request returns datapoint_not_applicable at no charge. Read the owner from legalRepresentatives.
shareholders
Not applicable. The request completes with a datapoint_not_applicable error (see below). No shareholder record is ever synthesized.
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:
{ "request": { "dataStatus": { "dataPoints": { "shareholders": { "status": "failed", "error": { "code": "datapoint_not_applicable", "message": "Sole entrepreneurs have no share capital, so no shareholder record exists. The owner is returned under legalRepresentatives and, where available, ultimateBeneficialOwners.", "retryable": false } } } } }}
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 rely on ultimateBeneficialOwners, which answers “who owns this business” for sole entrepreneurs too, except in the manual-certificate countries listed above, where legalRepresentatives carries the owner.
Associations, foundations, and similar non-profit forms (French association loi 1901, German e.V., Irish CLGs, and equivalents) have members and boards, not shareholders.
Datapoint
Behavior
company
Returned normally, with the non-profit legal form.
legalRepresentatives
The officers/board members the register publishes (president, treasurer, directors, …).
shareholders
Not applicable where the legal form has no share capital: same datapoint_not_applicable semantics as sole entrepreneurs. Where a register genuinely publishes founder or member equity records (some countries do for specific forms), those records are returned as published.
ultimateBeneficialOwners
Follows each country’s register rules. Some beneficial-ownership registers include non-profit officers, others don’t. Check the country guide.
Brazil returns the identified sole proprietor and published non-profit officers or board members under legalRepresentatives in prefill mode. Their shareholders datapoint returns datapoint_not_applicable while company and representative results can succeed. Certified UBO is unavailable. See the Brazil guide.
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.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Topograph","colors":{"primary":"#0D9373","light":"#07C983","dark":"#0D9373"},"logo":{"light":"https://mintcdn.com/semaphore/ChRp9mNNuCx3xt6W/logo/logo-dark.svg?fit=max\u0026auto=format\u0026n=ChRp9mNNuCx3xt6W\u0026q=85\u0026s=e6ce7b79992dddb6e7039eeceb3a0789","dark":"https://mintcdn.com/semaphore/ChRp9mNNuCx3xt6W/logo/logo-white.svg?fit=max\u0026auto=format\u0026n=ChRp9mNNuCx3xt6W\u0026q=85\u0026s=d2f2d6ec4b9b9ce743f9fb636e960c61"},"favicon":"https://mintcdn.com/semaphore/VQGxb8ZspQ9IKdXE/logo/icon-dark.svg?fit=max\u0026auto=format\u0026n=VQGxb8ZspQ9IKdXE\u0026q=85\u0026s=7696fde22b7a31bdfaf7bc85ac494e2c","navbar":{"links":[{"href":"https://topograph.co/pricing","label":"Pricing"},{"href":"https://app.topograph.co","label":"Dashboard"},{"href":"https://status.topograph.co","label":"Status"},{"href":"mailto:contact@topograph.co","label":"Support"}]},"footer":{"socials":{"x":"https://x.com/gettopograph","linkedin":"https://www.linkedin.com/company/topograph-data"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"semaphore","hasAudioNarration":false,"actualSubdomain":"semaphore","customDomains":["docs.topograph.co"],"gitSource":{"type":"github","owner":"getsemaphore","repo":"semaphore-api","deployBranch":"main","contentDirectory":"apps/docs","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6adb6338cf9bd761b140239d","collectionId":"a85b716a-fd79-44bc-afe0-7fa669503ed7","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6adb6338cf9bd761b140239d"},"feedback":{"thumbs":false,"agentFeedback":true},"entitlements":{},"buildId":"6adb6338cf9bd761b140239d","clientVersion":"0.0.3965","searchFilterCounts":[{"language":"default","tag":"Country Guides","count":112},{"language":"default","tag":"North America","count":63},{"language":"default","tag":"Documentation","count":37},{"language":"default","tag":"Europe","count":36},{"language":"default","tag":"API Reference","count":29},{"language":"default","tag":"Core Features","count":20},{"language":"default","tag":"Offshore Centers","count":10},{"language":"default","tag":"Behavior \u0026 Operations","count":7},{"language":"default","tag":"Billing Notifications","count":6},{"language":"default","tag":"Monitors","count":5}]},"assistantConfig":{},"hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-v7-file-tree","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"pause-universal-search-reconcile","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"per-site-search-delta","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-private-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-nav-generations","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-agent-model-picker","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"isAtlas":false,"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"essentials/entity-types","slug":"/essentials/entity-types","pageMetadata":{"title":"Sole Entrepreneurs \u0026 Non-Profits","description":"How each datapoint behaves for natural-person businesses and non-profit entities","icon":"user-tie","href":"/essentials/entity-types"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"How each datapoint behaves for natural-person businesses and non-profit entities\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,em:`em`,li:`li`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Heading,Table,Tip}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Tip)_missingMdxReference(`Tip`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`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: `,_jsx(_components.strong,{children:`sole entrepreneurs`}),` (natural-person businesses) and `,_jsx(_components.strong,{children:`non-profits`}),` (associations, foundations, and similar forms).`]}),`\n`,_jsx(_components.p,{children:`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.`}),`\n`,_jsx(Heading,{level:`2`,id:`sole-entrepreneurs`,children:`Sole entrepreneurs`}),`\n`,_jsxs(_components.p,{children:[`A sole entrepreneur (French `,_jsx(_components.em,{children:`entrepreneur individuel`}),`, German `,_jsx(_components.em,{children:`eingetragener Kaufmann`}),`, Bulgarian `,_jsx(_components.em,{children:`едноличен търговец (ЕТ)`}),`, Italian `,_jsx(_components.em,{children:`ditta individuale`}),`, Greek `,_jsx(_components.em,{children:`ατομική επιχείρηση`}),`, Ukrainian `,_jsx(_components.em,{children:`ФОП`}),`, 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.`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Datapoint`}),_jsx(_components.th,{children:`Behavior`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`company`})}),_jsxs(_components.td,{children:[`Returned normally. `,_jsx(_components.code,{children:`legalForm.standardized`}),` is `,_jsx(_components.code,{children:`Sole Proprietorship`}),`, so you can recognize the entity type from the response.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`legalRepresentatives`})}),_jsxs(_components.td,{children:[_jsx(_components.strong,{children:`Always the person.`}),` The owner is returned as the legal representative with the identity fields the register publishes (name, and where available date of birth, address, nationality). This is the record you need for sanctions/PEP screening.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`ultimateBeneficialOwners`})}),_jsxs(_components.td,{children:[_jsx(_components.strong,{children:`The person, at 100%.`}),` AML frameworks deem the sole trader the beneficial owner of the business, so where the country exposes a UBO datapoint, the owner is returned with 100% direct ownership, even when no separate UBO declaration exists in the register. `,_jsx(_components.strong,{children:`Exception:`}),` in countries where beneficial owners come from an official certificate obtained manually (Croatia, Cyprus, Germany without your own register access, Ireland, Portugal, Slovakia, Slovenia, China), a sole trader has no certificate, so the request returns `,_jsx(_components.code,{children:`datapoint_not_applicable`}),` at no charge. Read the owner from `,_jsx(_components.code,{children:`legalRepresentatives`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`shareholders`})}),_jsxs(_components.td,{children:[_jsx(_components.strong,{children:`Not applicable.`}),` The request completes with a `,_jsx(_components.code,{children:`datapoint_not_applicable`}),` error (see below). No shareholder record is ever synthesized.`]})]})]})]}),`\n`,_jsxs(Heading,{level:`3`,id:`the-datapoint_not_applicable-response`,children:[`The `,_jsx(_components.code,{children:`datapoint_not_applicable`}),` response`]}),`\n`,_jsxs(_components.p,{children:[`Requesting `,_jsx(_components.code,{children:`shareholders`}),` for a sole entrepreneur does not fail silently and does not return a misleading empty array. The datapoint completes as `,_jsx(_components.code,{children:`failed`}),` with a dedicated, machine-readable error code:`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`16`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`16`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"request\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"dataStatus\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"dataPoints\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"shareholders\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"failed\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"error\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"code\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"datapoint_not_applicable\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Sole entrepreneurs have no share capital, so no shareholder record exists. The owner is returned under legalRepresentatives and, where available, ultimateBeneficialOwners.\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"retryable\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`false`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`Key properties:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`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.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`You are not charged`}),` when `,_jsx(_components.code,{children:`shareholders`}),` is the only datapoint of its billing block in the request: the block is automatically refunded like any other unfulfilled datapoint. When `,_jsx(_components.code,{children:`shareholders`}),` shares a block with datapoints that did deliver (for example `,_jsx(_components.code,{children:`company`}),`), the block is billed once, as usual.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`The ownership answer still exists`}),`: read it from `,_jsx(_components.code,{children:`legalRepresentatives`}),` and `,_jsx(_components.code,{children:`ultimateBeneficialOwners`}),` instead.`]}),`\n`]}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[`If your pipeline iterates all datapoints uniformly, branch on `,_jsx(_components.code,{children:`error.code === \"datapoint_not_applicable\"`}),` to skip the ownership module for these entities, or rely on `,_jsx(_components.code,{children:`ultimateBeneficialOwners`}),`, which answers “who owns this business” for sole entrepreneurs too, except in the manual-certificate countries listed above, where `,_jsx(_components.code,{children:`legalRepresentatives`}),` carries the owner.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`non-profits`,children:`Non-profits`}),`\n`,_jsxs(_components.p,{children:[`Associations, foundations, and similar non-profit forms (French `,_jsx(_components.em,{children:`association loi 1901`}),`, German `,_jsx(_components.em,{children:`e.V.`}),`, Irish CLGs, and equivalents) have members and boards, not shareholders.`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Datapoint`}),_jsx(_components.th,{children:`Behavior`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`company`})}),_jsx(_components.td,{children:`Returned normally, with the non-profit legal form.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`legalRepresentatives`})}),_jsx(_components.td,{children:`The officers/board members the register publishes (president, treasurer, directors, …).`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`shareholders`})}),_jsxs(_components.td,{children:[_jsx(_components.strong,{children:`Not applicable`}),` where the legal form has no share capital: same `,_jsx(_components.code,{children:`datapoint_not_applicable`}),` semantics as sole entrepreneurs. Where a register genuinely publishes founder or member equity records (some countries do for specific forms), those records are returned as published.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`ultimateBeneficialOwners`})}),_jsx(_components.td,{children:`Follows each country’s register rules. Some beneficial-ownership registers include non-profit officers, others don’t. Check the country guide.`})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`coverage-notes`,children:`Coverage notes`}),`\n`,_jsxs(_components.p,{children:[`Brazil returns the identified sole proprietor and published non-profit officers or board members under `,_jsx(_components.code,{children:`legalRepresentatives`}),` in prefill mode. Their `,_jsx(_components.code,{children:`shareholders`}),` datapoint returns `,_jsx(_components.code,{children:`datapoint_not_applicable`}),` while company and representative results can succeed. Certified UBO is unavailable. See the `,_jsx(_components.a,{href:`https://www.topograph.co/countries/br`,children:`Brazil guide`}),`.`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`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 `,_jsx(_components.code,{children:`resource_not_found`}),`: a coverage fact, not an entity-type rule. Country-level coverage is on each `,_jsx(_components.a,{href:`/essentials/coverage-and-pricing`,children:`country guide`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`The rollout of the explicit `,_jsx(_components.code,{children:`datapoint_not_applicable`}),` response is per-country. Countries not yet converted may still return an empty `,_jsx(_components.code,{children:`shareholders`}),` array for these entity types; treat an empty array for a `,_jsx(_components.code,{children:`Sole Proprietorship`}),` legal form the same way you would treat the explicit code.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`related-pages`,children:`Related pages`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.a,{href:`/guides/reliability-and-errors`,children:`Reliability \u0026 Errors`}),`: the full error-code catalog`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.a,{href:`/essentials/shareholders-extraction`,children:`Shareholders Extraction`}),`: how shareholder data is sourced for regular companies`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.a,{href:`/essentials/coverage-and-pricing`,children:`Coverage \u0026 Pricing`}),`: per-country entity coverage`]}),`\n`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Sole Entrepreneurs \u0026 Non-Profits","description":"How each datapoint behaves for natural-person businesses and non-profit entities","icon":"user-tie","href":"/essentials/entity-types"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Sole entrepreneurs","slug":"sole-entrepreneurs","depth":2,"children":[{"title":"The datapoint_not_applicable response","slug":"the-datapoint_not_applicable-response","depth":3,"children":[]}]},{"title":"Non-profits","slug":"non-profits","depth":2,"children":[]},{"title":"Coverage notes","slug":"coverage-notes","depth":2,"children":[]},{"title":"Related pages","slug":"related-pages","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/semaphore/6431d896b4d06b6a/snitcher.js"],"subdomain":"semaphore","siteName":"Topograph","title":"Sole Entrepreneurs \u0026 Non-Profits - Topograph","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-14T08:22:40.776Z","originalFileLocation":"essentials/entity-types.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"How each datapoint behaves for natural-person businesses and non-profit entities\">\u003cmeta data-mint-head name=\"application-name\" content=\"Topograph\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/semaphore/dO1LV7k9tlVmoSjK/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/semaphore/dO1LV7k9tlVmoSjK/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/semaphore/dO1LV7k9tlVmoSjK/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/semaphore/dO1LV7k9tlVmoSjK/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/semaphore/dO1LV7k9tlVmoSjK/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/semaphore/dO1LV7k9tlVmoSjK/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/semaphore/dO1LV7k9tlVmoSjK/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/semaphore/dO1LV7k9tlVmoSjK/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/semaphore/dO1LV7k9tlVmoSjK/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Sole Entrepreneurs \u0026amp; Non-Profits - Topograph\">\u003cmeta data-mint-head property=\"og:description\" content=\"How each datapoint behaves for natural-person businesses and non-profit entities\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Topograph\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.topograph.co/essentials/entity-types\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://semaphore.mintlify.app/_mintlify/api/og/v2?division=Core+Features\u0026amp;title=Sole+Entrepreneurs+%26+Non-Profits\u0026amp;description=How+each+datapoint+behaves+for+natural-person+businesses+and+non-profit+entities\u0026amp;theme=996e54fd174205253948e175\u0026amp;signature=cfae128b6017214d00d1c15e208bdaf6c6e165f45e595d025aa456aa3041d500\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Sole Entrepreneurs \u0026amp; Non-Profits - Topograph\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"How each datapoint behaves for natural-person businesses and non-profit entities\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://semaphore.mintlify.app/_mintlify/api/og/v2?division=Core+Features\u0026amp;title=Sole+Entrepreneurs+%26+Non-Profits\u0026amp;description=How+each+datapoint+behaves+for+natural-person+businesses+and+non-profit+entities\u0026amp;theme=996e54fd174205253948e175\u0026amp;signature=cfae128b6017214d00d1c15e208bdaf6c6e165f45e595d025aa456aa3041d500\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/semaphore/dO1LV7k9tlVmoSjK/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Topograph\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0D9373\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.topograph.co/essentials/entity-types\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/essentials/entity-types.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.topograph.co/#organization\",\"name\":\"Topograph\",\"url\":\"https://docs.topograph.co\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/semaphore/ChRp9mNNuCx3xt6W/logo/logo-dark.svg?fit=max\u0026auto=format\u0026n=ChRp9mNNuCx3xt6W\u0026q=85\u0026s=e6ce7b79992dddb6e7039eeceb3a0789\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.topograph.co#website\",\"name\":\"Topograph\",\"url\":\"https://docs.topograph.co\",\"publisher\":{\"@id\":\"https://docs.topograph.co/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.topograph.co/essentials/entity-types#webpage\",\"url\":\"https://docs.topograph.co/essentials/entity-types\",\"name\":\"Sole Entrepreneurs \u0026 Non-Profits\",\"description\":\"How each datapoint behaves for natural-person businesses and non-profit entities\",\"dateModified\":\"2026-10-14T08:22:40.776Z\",\"isPartOf\":{\"@id\":\"https://docs.topograph.co#website\"},\"breadcrumb\":{\"@id\":\"https://docs.topograph.co/essentials/entity-types#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.topograph.co/essentials/entity-types#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Core Features\",\"item\":\"https://docs.topograph.co/essentials/coverage-and-pricing\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Sole Entrepreneurs \u0026 Non-Profits\",\"item\":\"https://docs.topograph.co/essentials/entity-types\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.topograph.co/essentials/entity-types#article\",\"headline\":\"Sole Entrepreneurs \u0026 Non-Profits\",\"name\":\"Sole Entrepreneurs \u0026 Non-Profits\",\"description\":\"How each datapoint behaves for natural-person businesses and non-profit entities\",\"url\":\"https://docs.topograph.co/essentials/entity-types\",\"mainEntityOfPage\":{\"@id\":\"https://docs.topograph.co/essentials/entity-types#webpage\"},\"dateModified\":\"2026-10-14T08:22:40.776Z\",\"publisher\":{\"@id\":\"https://docs.topograph.co/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.topograph.co#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Topograph\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Topograph","nav":{"global":null,"tabs":[{"tab":"Documentation","groups":[{"group":"Getting Started","pages":[{"title":"Introduction","icon":"book-open","href":"/introduction"},{"title":"Quickstart","icon":"bolt","href":"/quickstart"},{"title":"Batches","icon":"table-list","href":"/guides/batches"},{"title":"Development Environment","icon":"flask","href":"/guides/development-environment"},{"title":"Test Country (deprecated)","icon":"flask-vial","href":"/guides/test-country"}]},{"group":"AI Agents","pages":[{"title":"Use Topograph from your AI agent","icon":"robot","href":"/guides/mcp"},{"title":"Topograph Wizard","icon":"wand-magic-sparkles","href":"/guides/topograph-mcp"}]},{"group":"Integration Guides","pages":[{"title":"KYB Onboarding Best Practices","icon":"rocket","href":"/guides/kyb-onboarding"},{"title":"Migrating to the Data Product Model","icon":"arrow-right-arrow-left","href":"/guides/migration-data-product-model"},{"title":"Register Data Complexity","icon":"database","href":"/guides/register-data-complexity"}]},{"group":"Core Features","pages":[{"title":"Coverage and pricing","icon":"globe","href":"/essentials/coverage-and-pricing"},{"title":"Company Search","icon":"magnifying-glass","href":"/essentials/search"},{"title":"Global Search","icon":"globe","href":"/guides/global-search"},{"title":"Company Data","icon":"building","href":"/essentials/retrieve_company"},{"title":"Verification vs Prefill Mode","icon":"bolt","href":"/essentials/modes"},{"title":"Document Retrieval","description":"List and download official company documents, signed URLs, progressive delivery, and block-based included documents","icon":"file-arrow-down","href":"/essentials/document-guide"},{"title":"Sole Entrepreneurs \u0026 Non-Profits","icon":"user-tie","href":"/essentials/entity-types"},{"title":"European Unique Identifier (EUID)","description":"Retrieve European company identifiers, understand coverage, and handle missing values","icon":"id-card","href":"/essentials/euid"},{"title":"Activity Codes","icon":"tags","href":"/essentials/activity-codes"},{"title":"Compliance Signals \u0026 Statutory Filings","icon":"calendar-check","href":"/essentials/compliance-signals"},{"title":"Financial Data Extraction","icon":"chart-line","href":"/essentials/financial-data-extraction"},{"title":"Shareholders Extraction","icon":"users","href":"/essentials/shareholders-extraction"},{"title":"Subsidiaries","icon":"network-wired","href":"/essentials/subsidiaries-extraction"},{"title":"Ownership Graph","icon":"diagram-project","href":"/essentials/ownership-graph"},{"title":"VAT Validation","icon":"file-certificate","href":"/essentials/vat-validation"},{"title":"Transliteration","icon":"language","href":"/essentials/transliteration"},{"title":"Company Monitoring","icon":"bell","href":"/essentials/monitoring"},{"title":"Workspaces","icon":"buildings","href":"/essentials/workspaces"},{"title":"Register Credentials","icon":"key","href":"/essentials/register-credentials"},{"title":"Manual Delivery","icon":"clock","href":"/essentials/manual-delivery"}]},{"group":"Behavior \u0026 Operations","pages":[{"title":"Pricing and caching","icon":"credit-card","href":"/essentials/pricing-and-caching"},{"title":"Data Standardization","icon":"sliders","href":"/guides/standardization"},{"title":"Company Status","icon":"circle-check","href":"/guides/company-status"},{"title":"Reliability \u0026 Errors","icon":"shield-check","href":"/guides/reliability-and-errors"},{"title":"Concurrency \u0026 Backfills","icon":"gauge","href":"/guides/concurrency-and-backfills"},{"title":"Webhooks","icon":"webhook","href":"/guides/webhooks"},{"title":"Billing Notifications","icon":"bell","href":"/guides/billing-notifications"}]}]},{"tab":"Country Guides","pages":[{"title":"Country Guides","href":"/essentials/austria"}]},{"tab":"API Reference","pages":[{"title":"API Reference","href":"/api-reference/search/search-for-companies"}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/changelog"}]}]},"title":"Sole Entrepreneurs \u0026 Non-Profits - Topograph","buildId":"dpl_849ArpqvBiCczQiT1Y1stNGpbqHT","deploymentId":"dpl_849ArpqvBiCczQiT1Y1stNGpbqHT","dynamics":[],"chunks":[]}