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.person.getDetailsV1('182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e');console.log(response.id);
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.person.get_details_v1(
"182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
)
print(response.id)
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.person.getDetailsV1('182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e');console.log(response.id);
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.person.get_details_v1(
"182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
)
print(response.id)
Retrieve detailed information about a natural person including their name, date of birth, city of residence, age, and their roles across multiple companies. This endpoint aggregates data about a person’s management positions, providing a complete profile of their business activities.Cost: 10 credits
{"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.3965","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/person","slug":"/endpoint/person","pageMetadata":{"title":"Person information","openapi":"GET /v1/person/{person_id}","description":null,"href":"/endpoint/person"},"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`,p:`p`,strong:`strong`,..._provideComponents(),...props.components},{Heading}=_components;if(!Heading)_missingMdxReference(`Heading`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`2`,id:`get-person-information`,children:`Get person information`}),`\n`,_jsx(_components.p,{children:`Retrieve detailed information about a natural person including their name, date of birth, city of residence, age, and their roles across multiple companies. This endpoint aggregates data about a person’s management positions, providing a complete profile of their business activities.`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Cost:`}),` 10 credits`]}),`\n`,_jsx(Heading,{level:`3`,id:`roles`,children:`Roles`}),`\n`,_jsxs(_components.p,{children:[`Each entry in `,_jsx(_components.code,{children:`management_positions`}),` carries a `,_jsx(_components.code,{children:`role_detail`}),` — see `,_jsx(_components.a,{href:`/roles`,children:`Roles`}),`.`]})]})}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":"Person information","openapi":"GET /v1/person/{person_id}","description":null,"href":"/endpoint/person"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Get person information","slug":"get-person-information","depth":2,"children":[{"title":"Roles","slug":"roles","depth":3,"children":[]}]}],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["v1"],"summary":"Get detailed person information","operationId":"getPerson","parameters":["d0ba546e-a94e-41c2-91cd-2c5412bf39bf"],"responses":{"200":"24659894-3f08-46ef-b60c-b4737cb7d7f3","400":"f0d9718f-fc28-471c-8d33-07a0c8bbf471","401":"2d8d57f4-6d36-41f6-9fa7-8a3085b1e99b","402":"bd81c755-d6d9-47e4-8ca1-6e8c5b185a60","404":"0eac4f1a-2f1c-4cb0-a28f-bc02282fbecd","429":"642464e3-a795-4575-b156-d8e73d2c10e8","500":"ba1e966d-efef-4dd1-aed3-38e5618caf6f"},"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.person.getDetailsV1('182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e');\n\nconsole.log(response.id);"},{"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.person.get_details_v1(\n \"182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e\",\n)\nprint(response.id)"},{"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.Person.GetDetailsV1(context.TODO(), \"182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e\")\n\tif err != nil {\n\t\tpanic(err.Error())\n\t}\n\tfmt.Printf(\"%+v\\n\", response.ID)\n}\n"},{"lang":"CLI","source":"openregister person get-details-v1 \\\n --api-key 'My API Key' \\\n --person-id 182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e"}],"method":"get","type":"path","servers":["a67e40ed-d470-4831-becd-db83fe737f53"],"security":["6befa001-9bbe-44cc-9ba8-dfad709f11da"],"path":"/v1/person/{person_id}","baseUrlOptions":["https://api.openregister.de"],"title":"Get detailed person information","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.person.getDetailsV1('182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e');\n\nconsole.log(response.id);"},{"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.person.get_details_v1(\n \"182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e\",\n)\nprint(response.id)"},{"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.Person.GetDetailsV1(context.TODO(), \"182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e\")\n\tif err != nil {\n\t\tpanic(err.Error())\n\t}\n\tfmt.Printf(\"%+v\\n\", response.ID)\n}\n"},{"lang":"CLI","source":"openregister person get-details-v1 \\\n --api-key 'My API Key' \\\n --person-id 182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e"}],"requiredOnlyExamples":false,"requestExampleType":"codeSamples","responseExampleType":"generated"},"dependencies":{"parameters":{"d0ba546e-a94e-41c2-91cd-2c5412bf39bf":{"name":"person_id","in":"path","description":"The id of the person","required":true,"schema":{"type":"string","format":"uuid","isRequired":true,"description":"The id of the person","uniqueKey":"","typeLabel":"string\u003cuuid>"}}},"responses":{"24659894-3f08-46ef-b60c-b4737cb7d7f3":{"description":"Successfully retrieved person data","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"description":"Unique person identifier.\nExample: cc78ab54-d958-49b8-bae7-2f6c0c308837\n","type":"string","isRequired":true,"uniqueKey":"id","typeLabel":"string"},"first_name":{"description":"First name of the person.\n","type":"string","isRequired":true,"uniqueKey":"first_name","typeLabel":"string"},"last_name":{"description":"Last name of the person.\n","type":"string","isRequired":true,"uniqueKey":"last_name","typeLabel":"string"},"date_of_birth":{"oneOf":[{"description":"Date of birth of the person.\nFormat: ISO 8601 (YYYY-MM-DD)\nExample: \"1990-01-01\"\n","type":"string","format":"date","isRequired":true,"uniqueKey":"date_of_birth.oneOf.0","typeLabel":"string\u003cdate>"},{"description":"Date of birth of the person.\nFormat: ISO 8601 (YYYY-MM-DD)\nExample: \"1990-01-01\"\n","type":"null","format":"date","isRequired":true,"uniqueKey":"date_of_birth.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"date_of_birth","typeLabel":"string\u003cdate> | null"},"age":{"oneOf":[{"description":"Age of the person.\n","type":"integer","isRequired":true,"uniqueKey":"age.oneOf.0","typeLabel":"integer"},{"description":"Age of the person.\n","type":"null","isRequired":true,"uniqueKey":"age.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"age","typeLabel":"integer | null"},"city":{"description":"City of the person.\n","type":"string","isRequired":true,"uniqueKey":"city","typeLabel":"string"},"management_positions":{"description":"Management positions of the person.\n","type":"array","items":{"type":"object","properties":{"register_id":{"type":"string","description":"Register ID of the company.\nExample: DE-HRB-F1103-267645\n","isRequired":true,"uniqueKey":"management_positions.items.[INDEX].register_id","typeLabel":"string"},"company_name":{"type":"string","description":"Name of the company.\nExample: \"Descartes Technologies GmbH\"\n","isRequired":true,"uniqueKey":"management_positions.items.[INDEX].company_name","typeLabel":"string"},"role":{"type":"string","description":"Raw role string as stored, kept for backwards compatibility. It is\nregister-level rather than bucketed, and for Prokura it carries a\nGerman string (\"Einzelprokura\", \"Gesamtprokura\", \"Prokura\").\nPrefer `role_detail`.\nExample: \"EXECUTIVE\"\n","deprecated":true,"isRequired":true,"uniqueKey":"management_positions.items.[INDEX].role","typeLabel":"string"},"role_detail":{"description":"The precise role as recorded in the register, plus ready-to-display\ntitles. A Vorstand and a Geschäftsführer differ here.\n","type":"object","properties":{"code":{"description":"The precise role as recorded in the register.\nExample: \"EXECUTIVE\" for a Vorstand, \"DIRECTOR\" for a\nGeschäftsführer — both have role \"DIRECTOR\".\n","type":"string","enum":["DIRECTOR","EMERGENCY_DIRECTOR","EXECUTIVE","CHAIRMAN","DEPUTY_CHAIRMAN","BOARD","PRESIDENT_BOARD","VICE_PRESIDENT_BOARD","PRESIDENT","MEMBER","NON_EXECUTIVE_DIRECTOR","BOARD_SECRETARY","BOARD_TREASURER","BOARD_SPORTS","BOARD_OTHER","REPRESENTATIVE","SECONDARY_REPRESENTATIVE","COURT_ORDERED_REPRESENTATIVE","PROKURA","PROKURA_SINGLE","PROKURA_JOINT","LIQUIDATOR","INSOLVENCY_DIRECTOR","PRELIMINARY_INSOLVENCY_DIRECTOR","OWNER","SHAREHOLDER","PARTNER","PERSONAL_LIABLE_DIRECTOR","LIMITED_PARTNER","OTHER"],"isRequired":true,"uniqueKey":"management_positions.items.[INDEX].role_detail.code","typeLabel":"enum\u003cstring>"},"label_de":{"description":"German title, gender-neutral, as shown on openregister.de.\nExample: \"Vorstand\"\n","type":"string","isRequired":true,"uniqueKey":"management_positions.items.[INDEX].role_detail.label_de","typeLabel":"string"},"label_de_short":{"description":"Abbreviated German title, for dense layouts such as tables.\nExample: \"Vst.\"\n","type":"string","isRequired":true,"uniqueKey":"management_positions.items.[INDEX].role_detail.label_de_short","typeLabel":"string"},"label_en":{"description":"English title. A translation for display, not a legal term — the\nGerman title is the one the register uses.\nExample: \"Executive Board Member\"\n","type":"string","isRequired":true,"uniqueKey":"management_positions.items.[INDEX].role_detail.label_en","typeLabel":"string"},"label_en_short":{"description":"Abbreviated English title, for dense layouts such as tables.\nExample: \"Exec. Board\"\n","type":"string","isRequired":true,"uniqueKey":"management_positions.items.[INDEX].role_detail.label_en_short","typeLabel":"string"}},"required":["code","label_de","label_de_short","label_en","label_en_short"],"isRequired":true,"uniqueKey":"management_positions.items.[INDEX].role_detail","typeLabel":"object"},"start_date":{"description":"Date when the person started the management position.\nFormat: ISO 8601 (YYYY-MM-DD)\nExample: \"2022-01-01\"\n","type":"string","format":"date","isRequired":true,"uniqueKey":"management_positions.items.[INDEX].start_date","typeLabel":"string\u003cdate>"},"end_date":{"description":"Date when the person ended the management position.\nFormat: ISO 8601 (YYYY-MM-DD)\nExample: \"2023-01-01\"\n","type":"string","format":"date","uniqueKey":"management_positions.items.[INDEX].end_date","typeLabel":"string\u003cdate>"}},"required":["register_id","company_name","role","role_detail","start_date"],"description":"All current and past management positions of the person.\n","uniqueKey":"management_positions.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"management_positions","typeLabel":"object[]"}},"required":["id","first_name","last_name","date_of_birth","age","city","age","management_positions"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"id":"\u003cstring>","first_name":"\u003cstring>","last_name":"\u003cstring>","date_of_birth":"2023-12-25","age":123,"city":"\u003cstring>","management_positions":[{"register_id":"\u003cstring>","company_name":"\u003cstring>","role":"\u003cstring>","role_detail":{"code":"DIRECTOR","label_de":"\u003cstring>","label_de_short":"\u003cstring>","label_en":"\u003cstring>","label_en_short":"\u003cstring>"},"start_date":"2023-12-25","end_date":"2023-12-25"}]}}},"exampleType":"generated"}},"exampleType":"generated"},"f0d9718f-fc28-471c-8d33-07a0c8bbf471":{"description":"Bad Request - Invalid parameters provided","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"2d8d57f4-6d36-41f6-9fa7-8a3085b1e99b":{"description":"Unauthorized - Authentication required","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"bd81c755-d6d9-47e4-8ca1-6e8c5b185a60":{"description":"Payment Required - Insufficient credits for this request","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"0eac4f1a-2f1c-4cb0-a28f-bc02282fbecd":{"description":"Not Found - Person ID doesn't exist","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"642464e3-a795-4575-b156-d8e73d2c10e8":{"description":"Too Many Requests - Rate limit exceeded","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"ba1e966d-efef-4dd1-aed3-38e5618caf6f":{"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":"Person information - OpenRegister","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-23T13:47:09.758Z","originalFileLocation":"endpoint/person.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=\"Person information - OpenRegister\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"OpenRegister\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.openregister.de/endpoint/person\">\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=Person\u0026amp;title=Person+information\u0026amp;theme=ff1ffa3927752d914b134951\u0026amp;signature=dccd5ddab3537c12dbed8d44e899812925f467a20421624caaf85e126d0635a9\">\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=\"Person information - OpenRegister\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://openregister.mintlify.app/_mintlify/api/og/v2?division=Person\u0026amp;title=Person+information\u0026amp;theme=ff1ffa3927752d914b134951\u0026amp;signature=dccd5ddab3537c12dbed8d44e899812925f467a20421624caaf85e126d0635a9\">\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/person\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/endpoint/person.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/person#webpage\",\"url\":\"https://docs.openregister.de/endpoint/person\",\"name\":\"Person information\",\"dateModified\":\"2026-10-23T13:47:09.758Z\",\"isPartOf\":{\"@id\":\"https://docs.openregister.de#website\"},\"breadcrumb\":{\"@id\":\"https://docs.openregister.de/endpoint/person#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.openregister.de/endpoint/person#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Person\",\"item\":\"https://docs.openregister.de/endpoint/filter-person\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Person information\",\"item\":\"https://docs.openregister.de/endpoint/person\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.openregister.de/endpoint/person#apireference\",\"headline\":\"Person information\",\"name\":\"Person information\",\"url\":\"https://docs.openregister.de/endpoint/person\",\"mainEntityOfPage\":{\"@id\":\"https://docs.openregister.de/endpoint/person#webpage\"},\"dateModified\":\"2026-10-23T13:47:09.758Z\",\"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","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","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","description":null,"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","description":null,"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":"Person information - OpenRegister","buildId":"dpl_849ArpqvBiCczQiT1Y1stNGpbqHT","deploymentId":"dpl_849ArpqvBiCczQiT1Y1stNGpbqHT","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-Bbp7I60D.js","utils-C3RIvJha.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-DqD-vLt8.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-B31Loprg.js","snippetPresets-DKpk-b8t.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-Cj65AhOR.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BXtn5gcC.js","shallow-RY2b03Cp.js","getApiPlaygroundDisplay-B0jeiPk3.js","CodeSnippet-CYgBjjwn.js","CodeSnippets-DOngDrYB.js","Page-n7I5XbKb.js","getPastedJson-DRQbJx-T.js","icon-CQiQCicY.js","MethodPill-BKTLdNtu.js","DuplicateIcon-B9jpAdat.js","createIcon-DCddRrXv.js","DynamicMarkdown-a8hUKrw6.js","SectionHeading-eECVV2eH.js","axios-vUo_bRtp.js","Markdown--GF7ZIpf.js","clsx-DZLdJUrt.js","lib--scc4DXi.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-2LoAhjKH.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-Zwc0ZncM.js"]}