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":"oregister","repo":"cap","deployBranch":"main","contentDirectory":"docs/api","isPrivate":true,"mountPath":"","label":"","_id":"6ae0bb2e64ae4738365a2b4c"},"feedback":{"thumbs":true,"agentFeedback":true},"entitlements":{},"buildId":"6aeb6ce708d17703d20e26d3","clientVersion":"0.0.4087","searchFilterCounts":[{"language":"default","tag":"API Reference","count":29},{"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":{},"basePath":"","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":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","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":"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":"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":"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":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","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":"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":"workos-sso-scim","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},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"comment-mode","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":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":["1bb8e473-b607-47bf-b544-d8aee97a820f"],"responses":{"200":"7b9d255c-c41b-4e6e-bab5-f50be69746a6","400":"0c495897-16d9-4a25-8f9d-1a5583a0b739","401":"c8077ba1-f0eb-4368-bdfe-d684567414b8","402":"264880a7-64b7-4bf7-aed0-5387a025074c","404":"783ffbb8-f8b8-442d-adc6-a374d1662858","429":"e1588874-4787-4928-9f88-0f64cfe8b948","500":"2e48d745-431f-4a71-8c97-a7f50f95dce6"},"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":["ebc426bc-2947-41d4-a460-0a2d8d597ac5"],"security":["700cc84a-f5fa-4d50-a7e4-c9a80d5eed1f"],"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":{"1bb8e473-b607-47bf-b544-d8aee97a820f":{"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":{"7b9d255c-c41b-4e6e-bab5-f50be69746a6":{"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"},"0c495897-16d9-4a25-8f9d-1a5583a0b739":{"description":"Bad Request - Invalid parameters provided","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"c8077ba1-f0eb-4368-bdfe-d684567414b8":{"description":"Unauthorized - Authentication required","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"264880a7-64b7-4bf7-aed0-5387a025074c":{"description":"Payment Required - Insufficient credits for this request","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"783ffbb8-f8b8-442d-adc6-a374d1662858":{"description":"Not Found - Person ID doesn't exist","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"e1588874-4787-4928-9f88-0f64cfe8b948":{"description":"Too Many Requests - Rate limit exceeded","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"2e48d745-431f-4a71-8c97-a7f50f95dce6":{"description":"Internal Server Error - An error occurred while processing the request","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}}},"security":{"700cc84a-f5fa-4d50-a7e4-c9a80d5eed1f":{"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":{"ebc426bc-2947-41d4-a460-0a2d8d597ac5":{"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-11-04T17:35:42.596Z","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.site/_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.site/_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-11-04T17:35:42.596Z\",\"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-11-04T17:35:42.596Z\",\"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":"Jobs","pages":[{"title":"Start Job","openapi":"POST /v1/jobs","href":"/endpoint/job-create"},{"title":"Get Job","openapi":"GET /v1/jobs/{job_id}","href":"/endpoint/job-get"}]},{"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":"Usage","pages":[{"title":"Credit usage","openapi":"GET /v1/credits","href":"/endpoint/credits"}]},{"group":"Developer Resources","pages":[{"title":"Authentication","href":"/authentication"},{"title":"Roles","href":"/roles"},{"title":"Filtering Guide","href":"/filtering"}]}]}]},"basePath":"","title":"Person information - OpenRegister","buildId":"dpl_FWZhTb2vab28gFGFH4ojka6qEznQ","deploymentId":"dpl_FWZhTb2vab28gFGFH4ojka6qEznQ","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CBsVopKK.js","utils-DZAk68jJ.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-D32AYZrP.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-D_A5_cny.js","snippetPresets-xNRfS9th.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-BIB25-tq.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-CydJ4w4j.js","shallow-CYPBeQSG.js","getApiPlaygroundDisplay-A5xJVBOu.js","CodeSnippet-BVRTgi3m.js","CodeSnippets-DjD6BSlt.js","Page-Dr40SSJq.js","getPastedJson-D4V4JyrR.js","icon-uhcnG22T.js","MethodPill-CM-ZQdGH.js","DuplicateIcon-B_WnOiNf.js","createIcon-CJsb8utt.js","DynamicMarkdown-D-2HDKEp.js","SectionHeading-KP5xmMgQ.js","axios-vUo_bRtp.js","Markdown-D_k0dg6k.js","clsx-DK3K4Z1S.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-DE3EVdvd.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-fN9H9n9g.js"]}