import Openregister from 'openregister';const client = new Openregister({ apiKey: process.env['OPENREGISTER_API_KEY'], // This is the default and can be omitted});const response = await client.company.getHistoricalOwnersV1('company_id');console.log(response.owners);
import os
from openregister import Openregister
client = Openregister(
api_key=os.environ.get("OPENREGISTER_API_KEY"), # This is the default and can be omitted
)
response = client.company.get_historical_owners_v1(
"company_id",
)
print(response.owners)
import Openregister from 'openregister';const client = new Openregister({ apiKey: process.env['OPENREGISTER_API_KEY'], // This is the default and can be omitted});const response = await client.company.getHistoricalOwnersV1('company_id');console.log(response.owners);
import os
from openregister import Openregister
client = Openregister(
api_key=os.environ.get("OPENREGISTER_API_KEY"), # This is the default and can be omitted
)
response = client.company.get_historical_owners_v1(
"company_id",
)
print(response.owners)
Retrieve the historical ownership changes of a company
Get the full ownership history of a company across all filed documents. Unlike the current owners endpoint, this endpoint returns ownership data from every shareholder list (Gesellschafterliste) ever filed, allowing you to trace how ownership has changed over time.Cost: 25 credits
This endpoint may need to process data before it can return a result. Depending on the state of the data, you will receive one of two responses:
Status
Meaning
200 OK
Data is ready — the response body contains the full ownership history.
202 Accepted
Processing is still in progress. Re-call the same endpoint until you receive a 200.
When you receive a 202, wait 30 seconds before retrying. Re-call the same endpoint with the same company_id. There is no separate job ID — simply poll until you get a 200.202 responses are not billed. Credits are only deducted when the endpoint returns 200 with data.
The response includes ownership snapshots across all filed documents. Each snapshot contains the document date, the owners at that point in time, their ownership stake (as percentage and/or nominal shares), and share capital. For corporate shareholders, you’ll receive the company ID to retrieve further details.
Ownership Analysis: Understand who has controlled a company over time and identify indirect ownership through corporate shareholders. Map ownership chains to reveal corporate structures.Funding Rounds: Analyze funding rounds and understand who invested when — trace new shareholders entering the cap table and stake changes over time to reconstruct the company’s funding history.Risk Assessment: Identify concentration of ownership, related party transactions, or complex ownership structures that may require additional scrutiny.Network Mapping: Track ownership connections between companies over time to identify business groups, family holdings, or corporate networks.
{"docsConfig":{"theme":"linden","$schema":"https://mintlify.com/docs.json","name":"OpenRegister","description":"OpenRegister API Documentation - Comprehensive access to German company data from official registers including Handelsregister and Bundesanzeiger","colors":{"primary":"#4A5596","light":"#557DFF","dark":"#5F83B4"},"logo":{"light":"https://mintcdn.com/openregister/I60lO8r_xbC-oGKy/logo-original.png?fit=max\u0026auto=format\u0026n=I60lO8r_xbC-oGKy\u0026q=85\u0026s=e7acfa9d524458e7811ee426ed39de9b","dark":"https://mintcdn.com/openregister/I60lO8r_xbC-oGKy/logo-white.png?fit=max\u0026auto=format\u0026n=I60lO8r_xbC-oGKy\u0026q=85\u0026s=cc50207be5ad3ad78a45b325511d445d","href":"https://openregister.de"},"favicon":"https://mintcdn.com/openregister/wMCWTTcoylU2MOZd/favicon.png?fit=max\u0026auto=format\u0026n=wMCWTTcoylU2MOZd\u0026q=85\u0026s=40287a824868c0def41f1bc751c78b9d","api":{"params":{"expanded":"closed"},"playground":{"display":"interactive","proxy":true}},"background":{"decoration":"grid","color":{"light":"#fafafc","dark":"#0b0c12"}},"navbar":{"links":[{"href":"mailto:founders@openregister.de","label":"Support"}],"primary":{"type":"button","label":"Website","href":"https://openregister.de"}},"footer":{"socials":{"linkedin":"https://www.linkedin.com/company/openregisters"}},"fonts":{"family":"Inter"},"styling":{"eyebrows":"breadcrumbs","codeblocks":"dark","latex":false},"contextual":{"options":["copy","view","chatgpt","claude"],"display":"header"},"navigation":{"global":{"anchors":[{"anchor":"Get your API key","icon":"key","href":"https://openregister.de/keys"},{"anchor":"Changelog","icon":"newspaper","href":"https://openregister.de/changelog"},{"anchor":"Status","icon":"signal","href":"https://status.openregister.de"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"openregister","hasAudioNarration":false,"actualSubdomain":"openregister","customDomains":["docs.openregister.de"],"gitSource":{"type":"github","owner":"joelrose","repo":"cap","deployBranch":"main","contentDirectory":"docs/api","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6adb6542935ad58d7118a975","collectionId":"3a974d52-28f9-4810-85ed-477c1a610e5f","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6adb6542935ad58d7118a975"},"feedback":{"thumbs":true,"agentFeedback":true},"entitlements":{},"buildId":"6adb6542935ad58d7118a975","clientVersion":"0.0.3966","searchFilterCounts":[{"language":"default","tag":"API Reference","count":26},{"language":"default","tag":"Learn","count":14},{"language":"default","tag":"Company","count":6},{"language":"default","tag":"Integration","count":5},{"language":"default","tag":"Data Sources","count":5},{"language":"default","tag":"Developer Resources","count":3},{"language":"default","tag":"Person","count":3},{"language":"default","tag":"Monitor","count":3},{"language":"default","tag":"Transparenzregister","count":3},{"language":"default","tag":"Overview","count":3}]},"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":[{"filePath":"style.css","content":""}],"page":{"pagePath":"endpoint/company-historical-owners","slug":"/endpoint/company-historical-owners","pageMetadata":{"title":"Company historical owners","openapi":"GET /v1/company/{company_id}/owners/historical","description":null,"href":"/endpoint/company-historical-owners"},"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={code:`code`,li:`li`,p:`p`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{Heading,Info,Table}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!Info)_missingMdxReference(`Info`,true);if(!Table)_missingMdxReference(`Table`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`2`,id:`retrieve-the-historical-ownership-changes-of-a-company`,children:`Retrieve the historical ownership changes of a company`}),`\n`,_jsx(_components.p,{children:`Get the full ownership history of a company across all filed documents. Unlike the current owners endpoint, this endpoint returns ownership data from every shareholder list (Gesellschafterliste) ever filed, allowing you to trace how ownership has changed over time.`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Cost:`}),` 25 credits`]}),`\n`,_jsx(Heading,{level:`3`,id:`async-processing`,children:`Async Processing`}),`\n`,_jsx(_components.p,{children:`This endpoint may need to process data before it can return a result. Depending on the state of the data, you will receive one of two responses:`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Status`}),_jsx(_components.th,{children:`Meaning`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`200 OK`})}),_jsx(_components.td,{children:`Data is ready — the response body contains the full ownership history.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`202 Accepted`})}),_jsxs(_components.td,{children:[`Processing is still in progress. Re-call the same endpoint until you receive a `,_jsx(_components.code,{children:`200`}),`.`]})]})]})]}),`\n`,_jsxs(Info,{children:[_jsxs(_components.p,{children:[`When you receive a `,_jsx(_components.code,{children:`202`}),`, wait `,_jsx(_components.strong,{children:`30 seconds`}),` before retrying. Re-call the same endpoint with the same `,_jsx(_components.code,{children:`company_id`}),`. There is no separate job ID — simply poll until you get a `,_jsx(_components.code,{children:`200`}),`.`]}),_jsxs(_components.p,{children:[_jsxs(_components.strong,{children:[_jsx(_components.code,{children:`202`}),` responses are not billed.`]}),` Credits are only deducted when the endpoint returns `,_jsx(_components.code,{children:`200`}),` with data.`]})]}),`\n`,_jsx(Heading,{level:`3`,id:`supported-legal-forms`,children:`Supported Legal Forms`}),`\n`,_jsx(_components.p,{children:`Historical ownership data is available for:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`GmbH`}),` (Gesellschaft mit beschränkter Haftung) - Limited liability company`]}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`ownership-data-structure`,children:`Ownership Data Structure`}),`\n`,_jsx(_components.p,{children:`The response includes ownership snapshots across all filed documents. Each snapshot contains the document date, the owners at that point in time, their ownership stake (as percentage and/or nominal shares), and share capital. For corporate shareholders, you’ll receive the company ID to retrieve further details.`}),`\n`,_jsx(Heading,{level:`3`,id:`use-cases`,children:`Use Cases`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Ownership Analysis:`}),` Understand who has controlled a company over time and identify indirect ownership through corporate shareholders. Map ownership chains to reveal corporate structures.`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Funding Rounds:`}),` Analyze funding rounds and understand who invested when — trace new shareholders entering the cap table and stake changes over time to reconstruct the company’s funding history.`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Risk Assessment:`}),` Identify concentration of ownership, related party transactions, or complex ownership structures that may require additional scrutiny.`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Network Mapping:`}),` Track ownership connections between companies over time to identify business groups, family holdings, or corporate networks.`]})]})}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":{"codeStyling":"dark","config":{},"pageMetadata":{"title":"Company historical owners","openapi":"GET /v1/company/{company_id}/owners/historical","description":null,"href":"/endpoint/company-historical-owners"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Retrieve the historical ownership changes of a company","slug":"retrieve-the-historical-ownership-changes-of-a-company","depth":2,"children":[{"title":"Async Processing","slug":"async-processing","depth":3,"children":[]},{"title":"Supported Legal Forms","slug":"supported-legal-forms","depth":3,"children":[]},{"title":"Ownership Data Structure","slug":"ownership-data-structure","depth":3,"children":[]},{"title":"Use Cases","slug":"use-cases","depth":3,"children":[]}]}],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["v1"],"summary":"Get historical owner changes","operationId":"getHistoricalOwners","parameters":["050bc676-23a2-4e50-ba28-062edbb8c302"],"responses":{"200":"b7f75012-d0ba-476c-950b-769653b0a7d0","202":"a636e8ce-95e7-4699-a729-17092d4e0985","400":"03377df5-3713-4d43-bc36-64b051fddbf1","401":"d3233725-fd6d-4613-96ca-81c9fcc103fb","402":"379089aa-19f5-48cb-a09f-ed9d4f4b7b60","404":"c7fd8447-6f0c-43a1-bfbc-31ce5d81fb49","429":"cf003a68-74cd-49ab-a824-d391aa494cf2","500":"0b8104a4-f815-4850-b5c9-087e19de68a3"},"x-codeSamples":[{"lang":"JavaScript","source":"import Openregister from 'openregister';\n\nconst client = new Openregister({\n apiKey: process.env['OPENREGISTER_API_KEY'], // This is the default and can be omitted\n});\n\nconst response = await client.company.getHistoricalOwnersV1('company_id');\n\nconsole.log(response.owners);"},{"lang":"Python","source":"import os\nfrom openregister import Openregister\n\nclient = Openregister(\n api_key=os.environ.get(\"OPENREGISTER_API_KEY\"), # This is the default and can be omitted\n)\nresponse = client.company.get_historical_owners_v1(\n \"company_id\",\n)\nprint(response.owners)"},{"lang":"Go","source":"package main\n\nimport (\n\t\"context\"\n\t\"fmt\"\n\n\t\"github.com/oregister/openregister-go\"\n\t\"github.com/oregister/openregister-go/option\"\n)\n\nfunc main() {\n\tclient := openregister.NewClient(\n\t\toption.WithAPIKey(\"My API Key\"),\n\t)\n\tresponse, err := client.Company.GetHistoricalOwnersV1(context.TODO(), \"company_id\")\n\tif err != nil {\n\t\tpanic(err.Error())\n\t}\n\tfmt.Printf(\"%+v\\n\", response.Owners)\n}\n"},{"lang":"CLI","source":"openregister company get-historical-owners-v1 \\\n --api-key 'My API Key' \\\n --company-id company_id"}],"method":"get","type":"path","servers":["a67e40ed-d470-4831-becd-db83fe737f53"],"security":["6befa001-9bbe-44cc-9ba8-dfad709f11da"],"path":"/v1/company/{company_id}/owners/historical","baseUrlOptions":["https://api.openregister.de"],"title":"Get historical owner changes","description":"","codeSamples":[{"lang":"JavaScript","source":"import Openregister from 'openregister';\n\nconst client = new Openregister({\n apiKey: process.env['OPENREGISTER_API_KEY'], // This is the default and can be omitted\n});\n\nconst response = await client.company.getHistoricalOwnersV1('company_id');\n\nconsole.log(response.owners);"},{"lang":"Python","source":"import os\nfrom openregister import Openregister\n\nclient = Openregister(\n api_key=os.environ.get(\"OPENREGISTER_API_KEY\"), # This is the default and can be omitted\n)\nresponse = client.company.get_historical_owners_v1(\n \"company_id\",\n)\nprint(response.owners)"},{"lang":"Go","source":"package main\n\nimport (\n\t\"context\"\n\t\"fmt\"\n\n\t\"github.com/oregister/openregister-go\"\n\t\"github.com/oregister/openregister-go/option\"\n)\n\nfunc main() {\n\tclient := openregister.NewClient(\n\t\toption.WithAPIKey(\"My API Key\"),\n\t)\n\tresponse, err := client.Company.GetHistoricalOwnersV1(context.TODO(), \"company_id\")\n\tif err != nil {\n\t\tpanic(err.Error())\n\t}\n\tfmt.Printf(\"%+v\\n\", response.Owners)\n}\n"},{"lang":"CLI","source":"openregister company get-historical-owners-v1 \\\n --api-key 'My API Key' \\\n --company-id company_id"}],"requiredOnlyExamples":false,"requestExampleType":"codeSamples","responseExampleType":"generated"},"dependencies":{"parameters":{"050bc676-23a2-4e50-ba28-062edbb8c302":{"name":"company_id","in":"path","required":true,"description":"Unique company identifier.\nExample: DE-HRB-F1103-267645\n","schema":{"type":"string","isRequired":true,"description":"Unique company identifier.\nExample: DE-HRB-F1103-267645\n","uniqueKey":"","typeLabel":"string"}}},"responses":{"b7f75012-d0ba-476c-950b-769653b0a7d0":{"description":"Successfully retrieved historical owner changes","content":{"application/json":{"schema":{"type":"object","properties":{"owners":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Unique identifier for the owner. For companies, this is the company register ID\n(e.g. DE-HRB-F1103-267645) which can be used to look up the company. For natural\npersons, this is the entity UUID. For other entity types (foreign companies,\nfoundations, etc.), this is empty.\n","isRequired":true,"uniqueKey":"owners.items.[INDEX].id","typeLabel":"string"},"name":{"type":"string","description":"Name of the owner","isRequired":true,"uniqueKey":"owners.items.[INDEX].name","typeLabel":"string"},"entity_type":{"type":"string","description":"Type of the owner entity","enum":["natural_person","german_company","foreign_company","german_government_entity","german_foundation","german_multiple_shareholder"],"isRequired":true,"uniqueKey":"owners.items.[INDEX].entity_type","typeLabel":"enum\u003cstring>"},"ownership_history":{"type":"array","items":{"type":"object","properties":{"document_id":{"type":"string","format":"uuid","description":"Document where this ownership data was found","isRequired":true,"uniqueKey":"owners.items.[INDEX].ownership_history.items.[INDEX].document_id","typeLabel":"string\u003cuuid>"},"document_date":{"type":"string","format":"date-time","description":"Date of the document","isRequired":true,"uniqueKey":"owners.items.[INDEX].ownership_history.items.[INDEX].document_date","typeLabel":"string\u003cdate-time>"},"nominal_shares":{"type":"integer","format":"int64","description":"Nominal value of shares in this document","isRequired":true,"uniqueKey":"owners.items.[INDEX].ownership_history.items.[INDEX].nominal_shares","typeLabel":"integer\u003cint64>"},"percentage_shares":{"type":"number","format":"double","description":"Percentage ownership in this document","isRequired":true,"uniqueKey":"owners.items.[INDEX].ownership_history.items.[INDEX].percentage_shares","typeLabel":"number\u003cdouble>"}},"required":["document_id","document_date","nominal_shares","percentage_shares"],"uniqueKey":"owners.items.[INDEX].ownership_history.items.[INDEX]","typeLabel":"object"},"description":"Historical ownership data across all documents","isRequired":true,"uniqueKey":"owners.items.[INDEX].ownership_history","typeLabel":"object[]"},"first_appearance":{"type":"string","format":"date-time","description":"Date when this owner first appeared","isRequired":true,"uniqueKey":"owners.items.[INDEX].first_appearance","typeLabel":"string\u003cdate-time>"},"status":{"type":"string","description":"Current status of the owner","enum":["active","removed"],"isRequired":true,"uniqueKey":"owners.items.[INDEX].status","typeLabel":"enum\u003cstring>"},"country":{"type":"string","description":"Country of the owner","uniqueKey":"owners.items.[INDEX].country","typeLabel":"string"},"last_appearance":{"type":"string","format":"date-time","description":"Date when this owner last appeared (null if still active)","uniqueKey":"owners.items.[INDEX].last_appearance","typeLabel":"string\u003cdate-time>"}},"required":["id","name","entity_type","ownership_history","first_appearance","status"],"uniqueKey":"owners.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"owners","typeLabel":"object[]"}},"required":["owners"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"owners":[{"id":"\u003cstring>","name":"\u003cstring>","entity_type":"natural_person","ownership_history":[{"document_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","document_date":"2023-11-07T05:31:56Z","nominal_shares":123,"percentage_shares":123}],"first_appearance":"2023-11-07T05:31:56Z","status":"active","country":"\u003cstring>","last_appearance":"2023-11-07T05:31:56Z"}]}}},"exampleType":"generated"}},"exampleType":"generated"},"a636e8ce-95e7-4699-a729-17092d4e0985":{"description":"Accepted - Historical owners are being processed, retry this request shortly","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"03377df5-3713-4d43-bc36-64b051fddbf1":{"description":"Bad Request - Invalid parameters provided","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"d3233725-fd6d-4613-96ca-81c9fcc103fb":{"description":"Unauthorized - Authentication required","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"379089aa-19f5-48cb-a09f-ed9d4f4b7b60":{"description":"Payment Required - Insufficient credits for this request","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"c7fd8447-6f0c-43a1-bfbc-31ce5d81fb49":{"description":"Not Found - Company ID doesn't exist or has no owner history","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"cf003a68-74cd-49ab-a824-d391aa494cf2":{"description":"Too Many Requests - Rate limit exceeded","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"0b8104a4-f815-4850-b5c9-087e19de68a3":{"description":"Internal Server Error - An error occurred while processing the request","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}}},"security":{"6befa001-9bbe-44cc-9ba8-dfad709f11da":{"BearerAuth":{"type":"http","scheme":"bearer","description":"API Key Authentication\nProvide your API key as a Bearer token in the Authorization header.\n\nRejected keys return a JSON body `{\"message\": \"...\"}` naming the reason:\n- 401 `API key is missing`, `API key is invalid`, `API key is disabled` or `API key has expired`\n- 429 `API key rate limit exceeded` or `API key usage limit exceeded`\n","scopes":[],"schemeName":"BearerAuth"}}},"servers":{"a67e40ed-d470-4831-becd-db83fe737f53":{"url":"https://api.openregister.de","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"API Key Authentication\nProvide your API key as a Bearer token in the Authorization header.\n\nRejected keys return a JSON body `{\"message\": \"...\"}` naming the reason:\n- 401 `API key is missing`, `API key is invalid`, `API key is disabled` or `API key has expired`\n- 429 `API key rate limit exceeded` or `API key usage limit exceeded`\n","scopes":[],"schemeName":"BearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"API Key Authentication\nProvide your API key as a Bearer token in the Authorization header.\n\nRejected keys return a JSON body `{\"message\": \"...\"}` naming the reason:\n- 401 `API key is missing`, `API key is invalid`, `API key is disabled` or `API key has expired`\n- 429 `API key rate limit exceeded` or `API key usage limit exceeded`\n","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"BearerAuth","name":"Authorization"}],"title":"BearerAuth"}]},"originalFileLocation":"openapi.yml"},"subdomain":"openregister","siteName":"OpenRegister","title":"Company historical owners - OpenRegister","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-23T13:47:09.764Z","originalFileLocation":"endpoint/company-historical-owners.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=\"application-name\" content=\"OpenRegister\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/openregister/LEfMcKOAmDfPTf6x/_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/openregister/LEfMcKOAmDfPTf6x/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/openregister/LEfMcKOAmDfPTf6x/_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/openregister/LEfMcKOAmDfPTf6x/_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/openregister/LEfMcKOAmDfPTf6x/_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/openregister/LEfMcKOAmDfPTf6x/_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/openregister/LEfMcKOAmDfPTf6x/_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/openregister/LEfMcKOAmDfPTf6x/_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/openregister/LEfMcKOAmDfPTf6x/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Company historical owners - OpenRegister\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"OpenRegister\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.openregister.de/endpoint/company-historical-owners\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://openregister.mintlify.app/_mintlify/api/og/v2?division=Company\u0026amp;title=Company+historical+owners\u0026amp;theme=ff1ffa3927752d914b134951\u0026amp;signature=7a76a209b67bf445aa95a3bbe1fc7049003343d9247a36f28b03979fb51a5880\">\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=\"Company historical owners - OpenRegister\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://openregister.mintlify.app/_mintlify/api/og/v2?division=Company\u0026amp;title=Company+historical+owners\u0026amp;theme=ff1ffa3927752d914b134951\u0026amp;signature=7a76a209b67bf445aa95a3bbe1fc7049003343d9247a36f28b03979fb51a5880\">\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/openregister/LEfMcKOAmDfPTf6x/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"OpenRegister\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#4A5596\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.openregister.de/endpoint/company-historical-owners\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/endpoint/company-historical-owners.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.openregister.de/#organization\",\"name\":\"OpenRegister\",\"url\":\"https://docs.openregister.de\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/openregister/I60lO8r_xbC-oGKy/logo-original.png?fit=max\u0026auto=format\u0026n=I60lO8r_xbC-oGKy\u0026q=85\u0026s=e7acfa9d524458e7811ee426ed39de9b\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.openregister.de#website\",\"name\":\"OpenRegister\",\"url\":\"https://docs.openregister.de\",\"publisher\":{\"@id\":\"https://docs.openregister.de/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.openregister.de/endpoint/company-historical-owners#webpage\",\"url\":\"https://docs.openregister.de/endpoint/company-historical-owners\",\"name\":\"Company historical owners\",\"dateModified\":\"2026-10-23T13:47:09.764Z\",\"isPartOf\":{\"@id\":\"https://docs.openregister.de#website\"},\"breadcrumb\":{\"@id\":\"https://docs.openregister.de/endpoint/company-historical-owners#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.openregister.de/endpoint/company-historical-owners#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Company\",\"item\":\"https://docs.openregister.de/endpoint/company\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Company historical owners\",\"item\":\"https://docs.openregister.de/endpoint/company-historical-owners\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.openregister.de/endpoint/company-historical-owners#apireference\",\"headline\":\"Company historical owners\",\"name\":\"Company historical owners\",\"url\":\"https://docs.openregister.de/endpoint/company-historical-owners\",\"mainEntityOfPage\":{\"@id\":\"https://docs.openregister.de/endpoint/company-historical-owners#webpage\"},\"dateModified\":\"2026-10-23T13:47:09.764Z\",\"publisher\":{\"@id\":\"https://docs.openregister.de/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.openregister.de#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"OpenRegister\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"OpenRegister","nav":{"global":{"anchors":[{"anchor":"Get your API key","icon":"key","href":"https://openregister.de/keys"},{"anchor":"Changelog","icon":"newspaper","href":"https://openregister.de/changelog"},{"anchor":"Status","icon":"signal","href":"https://status.openregister.de"}]},"tabs":[{"tab":"Learn","pages":[{"title":"Learn","href":"/introduction"}]},{"tab":"API Reference","groups":[{"group":"Search","pages":[{"title":"Simple company search","openapi":"GET /v1/autocomplete/company","href":"/endpoint/autocomplete-company"},{"title":"Advanced company search","openapi":"POST /v1/search/company","href":"/endpoint/filter-company"}]},{"group":"Company","pages":[{"title":"Company information","openapi":"GET /v1/company/{company_id}","href":"/endpoint/company"},{"title":"Company owners","openapi":"GET /v1/company/{company_id}/owners","href":"/endpoint/company-owners"},{"title":"Company holdings","openapi":"GET /v1/company/{company_id}/holdings","href":"/endpoint/company-holdings"},{"title":"Financials","openapi":"GET /v1/company/{company_id}/financials","href":"/endpoint/company-financials"},{"title":"Company UBOs","openapi":"GET /v1/company/{company_id}/ubo","description":null,"href":"/endpoint/company-ubo"},{"title":"Company historical owners","openapi":"GET /v1/company/{company_id}/owners/historical","href":"/endpoint/company-historical-owners"}]},{"group":"Document","pages":[{"title":"Document Realtime","openapi":"GET /v1/document","description":null,"href":"/endpoint/document-realtime"},{"title":"Document Stored","openapi":"GET /v1/document/{document_id}","href":"/endpoint/document-stored"}]},{"group":"Web Data","pages":[{"title":"Search by website URL","openapi":"GET /v0/search/lookup","href":"/endpoint/search-lookup"},{"title":"Contact information","openapi":"GET /v0/company/{company_id}/contact","href":"/endpoint/company-contact"}]},{"group":"Monitor","pages":[{"title":"Create Monitor","openapi":"POST /v1/monitor","href":"/endpoint/monitor-create"},{"title":"Delete Monitor","openapi":"DELETE /v1/monitor/{entity_id}","href":"/endpoint/monitor-delete"},{"title":"List Monitors","openapi":"GET /v1/monitor","href":"/endpoint/monitor-list"}]},{"group":"Person","pages":[{"title":"Search person","openapi":"POST /v1/search/person","href":"/endpoint/filter-person"},{"title":"Person information","openapi":"GET /v1/person/{person_id}","href":"/endpoint/person"},{"title":"Person holdings","openapi":"GET /v1/person/{person_id}/holdings","href":"/endpoint/person-holdings"}]},{"group":"Insolvency","pages":[{"title":"Insolvency search","openapi":"POST /v1/search/insolvency","href":"/endpoint/search-insolvency"},{"title":"Insolvency proceeding","openapi":"GET /v1/insolvency/{insolvency_id}","href":"/endpoint/insolvency"}]},{"group":"Transparenzregister","pages":[{"title":"Store credentials","openapi":"POST /v1/transparenzregister/credentials","href":"/endpoint/transparenzregister-credentials"},{"title":"Order extract","openapi":"POST /v1/transparenzregister/extracts","href":"/endpoint/transparenzregister-extract-create"},{"title":"Get extract","openapi":"GET /v1/transparenzregister/extracts/{extract_id}","href":"/endpoint/transparenzregister-extract-get"}]},{"group":"Developer Resources","pages":[{"title":"Authentication","href":"/authentication"},{"title":"Roles","href":"/roles"},{"title":"Filtering Guide","href":"/filtering"}]}]}]},"title":"Company historical owners - OpenRegister","buildId":"dpl_cadrRc5H9XQiJQbDFN5mcYRs2PAj","deploymentId":"dpl_cadrRc5H9XQiJQbDFN5mcYRs2PAj","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-DKJwRUt2.js","utils-CWD_VS3u.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-oFjciODD.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-C76WsxC3.js","snippetPresets-DvPMxpX_.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-CuNQfndH.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BVFpVUoF.js","shallow-t59Jg5Kr.js","getApiPlaygroundDisplay-C_JZ4amX.js","CodeSnippet-CLRDnx_h.js","CodeSnippets-C2myU4kc.js","Page-7TwLLapg.js","getPastedJson-B-JaVXw7.js","icon-BA-iDhH3.js","MethodPill-D4qZABFp.js","DuplicateIcon-THIDKO1O.js","createIcon-CYYJwgFd.js","DynamicMarkdown-UGQuxDKp.js","SectionHeading-jYELb23h.js","axios-vUo_bRtp.js","Markdown-DKsLa3wy.js","clsx-CefdjKz2.js","lib--scc4DXi.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-BaREnp3o.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-sgx_0XzF.js"]}