Returns a job’s status and, once it completed, its result. Poll this endpoint after starting a job until status is completed or failed, or wait for the job’s webhook and read the result here.Recommended polling interval: every 5–10 seconds.Cost: 0 credits
The document url is short-lived and presigned again on every read; read the job again for a fresh one.Results are returned for 12 hours after the job finished, until expires_at. After that results is null; read the regular endpoints instead. results is also null while the job is pending and when it failed.
Company the job refreshes. For company and owners jobs this is the company's latest register ID,
which differs from the requested one when the company moved to another register.
Example: DE-HRB-F1103-267645
{"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"},"chroma":{"liveDeploymentHistoryId":"6aeb6255e7f2f8d1e96fa289","collectionId":"01b4fef4-c506-4620-b202-3e50117dc069","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6aeb6255e7f2f8d1e96fa289"},"feedback":{"thumbs":true,"agentFeedback":true},"entitlements":{},"buildId":"6aeb6ce708d17703d20e26d3","clientVersion":"0.0.4054","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":"vite-origin","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":"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}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":""}],"page":{"pagePath":"endpoint/job-get","slug":"/endpoint/job-get","pageMetadata":{"title":"Get Job","openapi":"GET /v1/jobs/{job_id}","description":"Get a job's status and, once it completed, its result in `results`. Polling is free.\n- `document` jobs return `results.document` with a download URL, presigned again on every read.\n- `company` jobs return `results.company`, the same as `GET /v1/company/{company_id}`.\n- `owners` jobs return `results.owners`, the same as `GET /v1/company/{company_id}/owners`.\n\nResults are returned for 12 hours after the job finished (`expires_at`); after that, `results` is\nnull and the regular endpoints serve the data.\n","href":"/endpoint/job-get"},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n li: \"li\",\n p: \"p\",\n ul: \"ul\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsxs(_components.p, {\n children: [\"Get a job’s status and, once it completed, its result in \", _jsx(_components.code, {\n children: \"results\"\n }), \". Polling is free.\"]\n }), \"\\n\", _jsxs(_components.ul, {\n children: [\"\\n\", _jsxs(_components.li, {\n children: [_jsx(_components.code, {\n children: \"document\"\n }), \" jobs return \", _jsx(_components.code, {\n children: \"results.document\"\n }), \" with a download URL, presigned again on every read.\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [_jsx(_components.code, {\n children: \"company\"\n }), \" jobs return \", _jsx(_components.code, {\n children: \"results.company\"\n }), \", the same as \", _jsx(_components.code, {\n children: \"GET /v1/company/{company_id}\"\n }), \".\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [_jsx(_components.code, {\n children: \"owners\"\n }), \" jobs return \", _jsx(_components.code, {\n children: \"results.owners\"\n }), \", the same as \", _jsx(_components.code, {\n children: \"GET /v1/company/{company_id}/owners\"\n }), \".\"]\n }), \"\\n\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"Results are returned for 12 hours after the job finished (\", _jsx(_components.code, {\n children: \"expires_at\"\n }), \"); after that, \", _jsx(_components.code, {\n children: \"results\"\n }), \" is\\nnull and the regular endpoints serve the data.\"]\n })]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{CodeBlock,Heading,Table}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Table)_missingMdxReference(`Table`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`2`,id:`get-a-job`,children:`Get a job`}),`\n`,_jsxs(_components.p,{children:[`Returns a job’s status and, once it completed, its result. Poll this endpoint after `,_jsx(_components.a,{href:`/endpoint/job-create`,children:`starting a job`}),` until `,_jsx(_components.code,{children:`status`}),` is `,_jsx(_components.code,{children:`completed`}),` or `,_jsx(_components.code,{children:`failed`}),`, or wait for the job’s webhook and read the result here.`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Recommended polling interval:`}),` every 5–10 seconds.`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Cost:`}),` 0 credits`]}),`\n`,_jsx(Heading,{level:`3`,id:`status-values`,children:`Status values`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Status`}),_jsx(_components.th,{children:`Meaning`}),_jsx(_components.th,{children:`What to do`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`pending`})}),_jsx(_components.td,{children:`Queued or still being fetched from the Handelsregister`}),_jsx(_components.td,{children:`Continue polling`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`completed`})}),_jsx(_components.td,{children:`The data was fetched`}),_jsxs(_components.td,{children:[`Read `,_jsx(_components.code,{children:`results`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`failed`})}),_jsxs(_components.td,{children:[`The job could not be completed, see `,_jsx(_components.code,{children:`reason`})]}),_jsx(_components.td,{children:`Terminal; start a new job`})]})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`results`,children:`Results`}),`\n`,_jsxs(_components.p,{children:[`A completed job returns its result in `,_jsx(_components.code,{children:`results`}),`. Only the field of the job’s type is set, the other two are `,_jsx(_components.code,{children:`null`}),`.`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Job type`}),_jsx(_components.th,{children:`Field`}),_jsx(_components.th,{children:`Content`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`document`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`results.document`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`url`}),`, `,_jsx(_components.code,{children:`file_name`}),` and `,_jsx(_components.code,{children:`file_date`}),` of the fetched document`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`company`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`results.company`})}),_jsxs(_components.td,{children:[`The company, as `,_jsx(_components.a,{href:`/endpoint/company`,children:_jsx(_components.code,{children:`GET /v1/company/{company_id}`})}),` returns it`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`owners`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`results.owners`})}),_jsxs(_components.td,{children:[`The owners, as `,_jsx(_components.a,{href:`/endpoint/company-owners`,children:_jsx(_components.code,{children:`GET /v1/company/{company_id}/owners`})}),` returns them`]})]})]})]}),`\n`,_jsxs(_components.p,{children:[`The document `,_jsx(_components.code,{children:`url`}),` is short-lived and presigned again on every read; read the job again for a fresh one.`]}),`\n`,_jsxs(_components.p,{children:[`Results are returned for 12 hours after the job finished, until `,_jsx(_components.code,{children:`expires_at`}),`. After that `,_jsx(_components.code,{children:`results`}),` is `,_jsx(_components.code,{children:`null`}),`; read the regular endpoints instead. `,_jsx(_components.code,{children:`results`}),` is also `,_jsx(_components.code,{children:`null`}),` while the job is pending and when it failed.`]}),`\n`,_jsx(CodeBlock,{filename:`Completed owners job`,numberOfLines:`20`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes dark-plus dark-plus`,style:{backgroundColor:`#0B0C0E`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`20`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#9CDCFE`,\"--shiki-dark\":`#9CDCFE`},children:` \"id\"`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#CE9178`,\"--shiki-dark\":`#CE9178`},children:`\"9e8a48af-fc0f-498f-8072-aeb087a8a0f9\"`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#9CDCFE`,\"--shiki-dark\":`#9CDCFE`},children:` \"type\"`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#CE9178`,\"--shiki-dark\":`#CE9178`},children:`\"owners\"`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#9CDCFE`,\"--shiki-dark\":`#9CDCFE`},children:` \"company_id\"`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#CE9178`,\"--shiki-dark\":`#CE9178`},children:`\"DE-HRB-F1103-267645\"`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#9CDCFE`,\"--shiki-dark\":`#9CDCFE`},children:` \"document_category\"`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#569CD6`,\"--shiki-dark\":`#569CD6`},children:`null`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#9CDCFE`,\"--shiki-dark\":`#9CDCFE`},children:` \"status\"`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#CE9178`,\"--shiki-dark\":`#CE9178`},children:`\"completed\"`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#9CDCFE`,\"--shiki-dark\":`#9CDCFE`},children:` \"reason\"`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#569CD6`,\"--shiki-dark\":`#569CD6`},children:`null`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#9CDCFE`,\"--shiki-dark\":`#9CDCFE`},children:` \"results\"`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#9CDCFE`,\"--shiki-dark\":`#9CDCFE`},children:` \"document\"`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#569CD6`,\"--shiki-dark\":`#569CD6`},children:`null`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#9CDCFE`,\"--shiki-dark\":`#9CDCFE`},children:` \"company\"`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#569CD6`,\"--shiki-dark\":`#569CD6`},children:`null`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#9CDCFE`,\"--shiki-dark\":`#9CDCFE`},children:` \"owners\"`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#9CDCFE`,\"--shiki-dark\":`#9CDCFE`},children:` \"company_id\"`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#CE9178`,\"--shiki-dark\":`#CE9178`},children:`\"DE-HRB-F1103-267645\"`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#9CDCFE`,\"--shiki-dark\":`#9CDCFE`},children:` \"owners\"`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`: [ `}),_jsx(_components.span,{style:{color:`#F44747`,\"--shiki-dark\":`#F44747`},children:`...`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:` ],`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#F44747`,\"--shiki-dark\":`#F44747`},children:` ...`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#9CDCFE`,\"--shiki-dark\":`#9CDCFE`},children:` \"expires_at\"`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#CE9178`,\"--shiki-dark\":`#CE9178`},children:`\"2026-11-05T01:48:59.936Z\"`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#9CDCFE`,\"--shiki-dark\":`#9CDCFE`},children:` \"created_at\"`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#CE9178`,\"--shiki-dark\":`#CE9178`},children:`\"2026-11-04T13:48:42.601Z\"`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#9CDCFE`,\"--shiki-dark\":`#9CDCFE`},children:` \"finished_at\"`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#CE9178`,\"--shiki-dark\":`#CE9178`},children:`\"2026-11-04T13:48:59.936Z\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`3`,id:`failure-reasons`,children:`Failure reasons`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Reason`}),_jsx(_components.th,{children:`Meaning`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`not_available`})}),_jsxs(_components.td,{children:[`The register holds no such document for this company (for `,_jsx(_components.code,{children:`owners`}),` jobs: no shareholder list)`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`timeout`})}),_jsx(_components.td,{children:`The Handelsregister did not answer in time; try again later`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`internal_error`})}),_jsx(_components.td,{children:`Any other failure`})]})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`error-cases`,children:`Error cases`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Status`}),_jsx(_components.th,{children:`Cause`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`401`})}),_jsx(_components.td,{children:`Authentication required`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`404`})}),_jsx(_components.td,{children:`No job with this ID for your account`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`500`})}),_jsx(_components.td,{children:`Internal server error`})]})]})]})]})}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":"Get Job","openapi":"GET /v1/jobs/{job_id}","description":"Get a job's status and, once it completed, its result in `results`. Polling is free.\n- `document` jobs return `results.document` with a download URL, presigned again on every read.\n- `company` jobs return `results.company`, the same as `GET /v1/company/{company_id}`.\n- `owners` jobs return `results.owners`, the same as `GET /v1/company/{company_id}/owners`.\n\nResults are returned for 12 hours after the job finished (`expires_at`); after that, `results` is\nnull and the regular endpoints serve the data.\n","href":"/endpoint/job-get"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Get a job","slug":"get-a-job","depth":2,"children":[{"title":"Status values","slug":"status-values","depth":3,"children":[]},{"title":"Results","slug":"results","depth":3,"children":[]},{"title":"Failure reasons","slug":"failure-reasons","depth":3,"children":[]},{"title":"Error cases","slug":"error-cases","depth":3,"children":[]}]}],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["v1"],"summary":"Get a job","description":"Get a job's status and, once it completed, its result in `results`. Polling is free.\n- `document` jobs return `results.document` with a download URL, presigned again on every read.\n- `company` jobs return `results.company`, the same as `GET /v1/company/{company_id}`.\n- `owners` jobs return `results.owners`, the same as `GET /v1/company/{company_id}/owners`.\n\nResults are returned for 12 hours after the job finished (`expires_at`); after that, `results` is\nnull and the regular endpoints serve the data.\n","operationId":"getJob","parameters":["55df5ff8-144e-4f45-8f34-c32b7a7114dd"],"responses":{"200":"575b25bd-2505-4a6d-b7f3-a6e53662c950","401":"07d9e9a2-9ac4-4171-8eb2-da724f05bd7d","404":"7bd98040-b26f-48f2-9506-f397e32fce35","500":"1b30a181-9050-48a6-abbe-9f3e1e23cfcb"},"method":"get","type":"path","servers":["ebc426bc-2947-41d4-a460-0a2d8d597ac5"],"security":["700cc84a-f5fa-4d50-a7e4-c9a80d5eed1f"],"path":"/v1/jobs/{job_id}","baseUrlOptions":["https://api.openregister.de"],"title":"Get a job","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"55df5ff8-144e-4f45-8f34-c32b7a7114dd":{"name":"job_id","in":"path","required":true,"description":"Job ID returned when the job was started.\nExample: f47ac10b-58cc-4372-a567-0e02b2c3d479\n","schema":{"type":"string","format":"uuid","isRequired":true,"description":"Job ID returned when the job was started.\nExample: f47ac10b-58cc-4372-a567-0e02b2c3d479\n","uniqueKey":"","typeLabel":"string\u003cuuid>"}}},"responses":{"575b25bd-2505-4a6d-b7f3-a6e53662c950":{"description":"The job","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Unique job identifier.\nExample: f47ac10b-58cc-4372-a567-0e02b2c3d479\n","isRequired":true,"uniqueKey":"id","typeLabel":"string\u003cuuid>"},"type":{"type":"string","enum":["company","owners","document"],"isRequired":true,"uniqueKey":"type","typeLabel":"enum\u003cstring>"},"company_id":{"type":"string","description":"Company the job refreshes. For `company` and `owners` jobs this is the company's latest register ID,\nwhich differs from the requested one when the company moved to another register.\nExample: DE-HRB-F1103-267645\n","isRequired":true,"uniqueKey":"company_id","typeLabel":"string"},"document_category":{"oneOf":[{"type":"string","enum":["current_printout","chronological_printout","historical_printout","structured_information","shareholder_list","articles_of_association"],"isRequired":true,"uniqueKey":"document_category.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","isRequired":true,"uniqueKey":"document_category.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"document_category","typeLabel":"enum\u003cstring> | null"},"status":{"type":"string","enum":["pending","completed","failed"],"isRequired":true,"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"reason":{"oneOf":[{"type":"string","description":"Why a failed job failed:\n- `not_available`: the register holds no such document for this company.\n- `timeout`: the Handelsregister did not answer in time; try again later.\n- `internal_error`: any other failure.\n","enum":["not_available","timeout","internal_error"],"isRequired":true,"uniqueKey":"reason.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","description":"Why a failed job failed:\n- `not_available`: the register holds no such document for this company.\n- `timeout`: the Handelsregister did not answer in time; try again later.\n- `internal_error`: any other failure.\n","enum":["not_available","timeout","internal_error"],"isRequired":true,"uniqueKey":"reason.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"reason","typeLabel":"enum\u003cstring> | null"},"results":{"oneOf":[{"type":"object","description":"What a completed job produced, until `expires_at`. Null while the job is pending, when it failed, and after the results expired.","required":["document","company","owners"],"properties":{"document":{"oneOf":[{"type":"object","description":"The fetched document of a `document` job.","required":["url","file_date","file_name"],"properties":{"url":{"type":"string","format":"uri","description":"Download URL of the document. It expires; read the job again for a new one.","isRequired":true,"uniqueKey":"results.oneOf.0.document.oneOf.0.url","typeLabel":"string\u003curi>"},"file_date":{"oneOf":[{"type":"string","format":"date","isRequired":true,"uniqueKey":"results.oneOf.0.document.oneOf.0.file_date.oneOf.0","typeLabel":"string\u003cdate>"},{"type":"null","format":"date","isRequired":true,"uniqueKey":"results.oneOf.0.document.oneOf.0.file_date.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"results.oneOf.0.document.oneOf.0.file_date","typeLabel":"string\u003cdate> | null"},"file_name":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"results.oneOf.0.document.oneOf.0.file_name.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"results.oneOf.0.document.oneOf.0.file_name.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"results.oneOf.0.document.oneOf.0.file_name","typeLabel":"string | null"}},"isRequired":true,"uniqueKey":"results.oneOf.0.document.oneOf.0","typeLabel":"object"},{"type":"null","isRequired":true,"uniqueKey":"results.oneOf.0.document.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"results.oneOf.0.document","typeLabel":"object | null"},"company":{"oneOf":[{"type":"object","description":"The refreshed company of a `company` job.","required":["id","register","registers","status","name","names","address","addresses","purpose","purposes","capital","capitals","representation","representation_rule","indicators","legal_form","documents","incorporated_at","notarized_at","terminated_at","merged_into","acquisitions","asset_spin_offs","profit_transfer_agreement","industry_codes","contact","estimates","sources"],"properties":{"id":{"type":"string","description":"Unique company identifier.\nExample: DE-HRB-F1103-267645\n","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.id","typeLabel":"string"},"register":{"type":"object","properties":{"register_number":{"type":"string","description":"Registration number in the company register.\nExample: \"230633\"\n","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.register.register_number","typeLabel":"string"},"register_type":{"type":"string","description":"Type of register where the company is recorded.\nExample: \"HRB\" (Commercial Register B)\n","enum":["HRB","HRA","PR","GnR","VR"],"isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.register.register_type","typeLabel":"enum\u003cstring>"},"register_court":{"type":"string","description":"Court where the company is registered.\nExample: \"Berlin (Charlottenburg)\"\n","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.register.register_court","typeLabel":"string"},"company_id":{"type":"string","description":"Unique company identifier.\nExample: DE-HRB-F1103-267645\n","uniqueKey":"results.oneOf.0.company.oneOf.0.register.company_id","typeLabel":"string"},"start_date":{"description":"Date when this registration information became effective.\nFormat: ISO 8601 (YYYY-MM-DD)\nExample: \"2022-01-01\"\n","type":"string","format":"date","uniqueKey":"results.oneOf.0.company.oneOf.0.register.start_date","typeLabel":"string\u003cdate>"}},"required":["register_number","register_type","register_court"],"description":"Current registration information of the company.\n","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.register","typeLabel":"object"},"registers":{"description":"Historical registration changes.\nShows how registration details changed over time.\n","type":"array","items":{"type":"object","properties":{"register_number":{"type":"string","description":"Registration number in the company register.\nExample: \"230633\"\n","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.registers.items.[INDEX].register_number","typeLabel":"string"},"register_type":{"type":"string","description":"Type of register where the company is recorded.\nExample: \"HRB\" (Commercial Register B)\n","enum":["HRB","HRA","PR","GnR","VR"],"isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.registers.items.[INDEX].register_type","typeLabel":"enum\u003cstring>"},"register_court":{"type":"string","description":"Court where the company is registered.\nExample: \"Berlin (Charlottenburg)\"\n","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.registers.items.[INDEX].register_court","typeLabel":"string"},"company_id":{"type":"string","description":"Unique company identifier.\nExample: DE-HRB-F1103-267645\n","uniqueKey":"results.oneOf.0.company.oneOf.0.registers.items.[INDEX].company_id","typeLabel":"string"},"start_date":{"description":"Date when this registration information became effective.\nFormat: ISO 8601 (YYYY-MM-DD)\nExample: \"2022-01-01\"\n","type":"string","format":"date","uniqueKey":"results.oneOf.0.company.oneOf.0.registers.items.[INDEX].start_date","typeLabel":"string\u003cdate>"}},"required":["register_number","register_type","register_court"],"uniqueKey":"results.oneOf.0.company.oneOf.0.registers.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.registers","typeLabel":"object[]"},"status":{"description":"Current status of the company:\n- active: Operating normally\n- inactive: No longer operating\n- liquidation: In the process of being dissolved\n","type":"string","enum":["active","inactive","liquidation"],"isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.status","typeLabel":"enum\u003cstring>"},"name":{"type":"object","properties":{"name":{"description":"Official company name including any legal form designations.\nExample: \"Descartes Technologies UG (haftungsbeschränkt)\"\n","type":"string","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.name.name","typeLabel":"string"},"legal_form":{"type":"string","description":"Legal form of the company at this point in time.\nExample: \"gmbh\" for Gesellschaft mit beschränkter Haftung\n","enum":["ag","eg","ek","ev","ewiv","foreign","foundation","gbr","ggmbh","gmbh","kg","kgaa","unknown","llp","municipal","ohg","se","ug"],"isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.name.legal_form","typeLabel":"enum\u003cstring>"},"start_date":{"description":"Date when this name became effective.\nFormat: ISO 8601 (YYYY-MM-DD)\nExample: \"2022-01-01\"\n","type":"string","format":"date","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.name.start_date","typeLabel":"string\u003cdate>"}},"required":["name","legal_form","start_date"],"description":"Current official name of the company.\n","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.name","typeLabel":"object"},"names":{"description":"Historical company names.\nShows how the company name changed over time.\n","type":"array","items":{"type":"object","properties":{"name":{"description":"Official company name including any legal form designations.\nExample: \"Descartes Technologies UG (haftungsbeschränkt)\"\n","type":"string","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.names.items.[INDEX].name","typeLabel":"string"},"legal_form":{"type":"string","description":"Legal form of the company at this point in time.\nExample: \"gmbh\" for Gesellschaft mit beschränkter Haftung\n","enum":["ag","eg","ek","ev","ewiv","foreign","foundation","gbr","ggmbh","gmbh","kg","kgaa","unknown","llp","municipal","ohg","se","ug"],"isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.names.items.[INDEX].legal_form","typeLabel":"enum\u003cstring>"},"start_date":{"description":"Date when this name became effective.\nFormat: ISO 8601 (YYYY-MM-DD)\nExample: \"2022-01-01\"\n","type":"string","format":"date","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.names.items.[INDEX].start_date","typeLabel":"string\u003cdate>"}},"required":["name","legal_form","start_date"],"uniqueKey":"results.oneOf.0.company.oneOf.0.names.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.names","typeLabel":"object[]"},"address":{"type":"object","properties":{"city":{"type":"string","description":"City or locality name.\nExample: \"Berlin\"\n","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.address.city","typeLabel":"string"},"country":{"description":"Country name.\nExample: \"Germany\"\n","type":"string","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.address.country","typeLabel":"string"},"start_date":{"description":"Date when this address became effective.\nFormat: ISO 8601 (YYYY-MM-DD)\nExample: \"2022-01-01\"\n","type":"string","format":"date","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.address.start_date","typeLabel":"string\u003cdate>"},"formatted_value":{"description":"Complete address formatted as a single string.\nExample: \"Musterstraße 1, 10117 Berlin, Germany\"\n","type":"string","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.address.formatted_value","typeLabel":"string"},"street":{"type":"string","description":"Street name and number.\nExample: \"Musterstraße 1\"\n","uniqueKey":"results.oneOf.0.company.oneOf.0.address.street","typeLabel":"string"},"postal_code":{"type":"string","description":"Postal or ZIP code.\nExample: \"10117\"\n","uniqueKey":"results.oneOf.0.company.oneOf.0.address.postal_code","typeLabel":"string"},"extra":{"description":"Additional address information such as c/o or attention line.\nExample: \"c/o Max Mustermann\"\n","type":"string","uniqueKey":"results.oneOf.0.company.oneOf.0.address.extra","typeLabel":"string"}},"required":["city","country","start_date","formatted_value"],"description":"Current registered address of the company.\n","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.address","typeLabel":"object"},"addresses":{"description":"Historical addresses.\nShows how the company address changed over time.\n","type":"array","items":{"type":"object","properties":{"city":{"type":"string","description":"City or locality name.\nExample: \"Berlin\"\n","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.addresses.items.[INDEX].city","typeLabel":"string"},"country":{"description":"Country name.\nExample: \"Germany\"\n","type":"string","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.addresses.items.[INDEX].country","typeLabel":"string"},"start_date":{"description":"Date when this address became effective.\nFormat: ISO 8601 (YYYY-MM-DD)\nExample: \"2022-01-01\"\n","type":"string","format":"date","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.addresses.items.[INDEX].start_date","typeLabel":"string\u003cdate>"},"formatted_value":{"description":"Complete address formatted as a single string.\nExample: \"Musterstraße 1, 10117 Berlin, Germany\"\n","type":"string","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.addresses.items.[INDEX].formatted_value","typeLabel":"string"},"street":{"type":"string","description":"Street name and number.\nExample: \"Musterstraße 1\"\n","uniqueKey":"results.oneOf.0.company.oneOf.0.addresses.items.[INDEX].street","typeLabel":"string"},"postal_code":{"type":"string","description":"Postal or ZIP code.\nExample: \"10117\"\n","uniqueKey":"results.oneOf.0.company.oneOf.0.addresses.items.[INDEX].postal_code","typeLabel":"string"},"extra":{"description":"Additional address information such as c/o or attention line.\nExample: \"c/o Max Mustermann\"\n","type":"string","uniqueKey":"results.oneOf.0.company.oneOf.0.addresses.items.[INDEX].extra","typeLabel":"string"}},"required":["city","country","start_date","formatted_value"],"uniqueKey":"results.oneOf.0.company.oneOf.0.addresses.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.addresses","typeLabel":"object[]"},"purpose":{"oneOf":[{"type":"object","description":"Current official business purpose of the company.\n","required":["purpose","start_date"],"properties":{"purpose":{"description":"Official description of the company's business activities and objectives.\nThis is the registered purpose as stated in official documents.\n","type":"string","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.purpose.oneOf.0.purpose","typeLabel":"string"},"start_date":{"description":"Date when this purpose became effective.\nFormat: ISO 8601 (YYYY-MM-DD)\nExample: \"2022-01-01\"\n","type":"string","format":"date","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.purpose.oneOf.0.start_date","typeLabel":"string\u003cdate>"}},"isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.purpose.oneOf.0","typeLabel":"object"},{"type":"null","description":"Current official business purpose of the company.\n","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.purpose.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.purpose","typeLabel":"object | null"},"purposes":{"description":"Historical business purposes.\nShows how the company purpose changed over time.\n","type":"array","items":{"type":"object","properties":{"purpose":{"description":"Official description of the company's business activities and objectives.\nThis is the registered purpose as stated in official documents.\n","type":"string","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.purposes.items.[INDEX].purpose","typeLabel":"string"},"start_date":{"description":"Date when this purpose became effective.\nFormat: ISO 8601 (YYYY-MM-DD)\nExample: \"2022-01-01\"\n","type":"string","format":"date","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.purposes.items.[INDEX].start_date","typeLabel":"string\u003cdate>"}},"required":["purpose","start_date"],"uniqueKey":"results.oneOf.0.company.oneOf.0.purposes.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.purposes","typeLabel":"object[]"},"capital":{"oneOf":[{"type":"object","description":"Current registered capital of the company.\n","required":["amount","currency","start_date"],"properties":{"amount":{"description":"Capital amount as a decimal number.\nExample: 100000.00 represents 100,000.00 monetary units\n","type":"number","format":"double","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.capital.oneOf.0.amount","typeLabel":"number\u003cdouble>"},"currency":{"description":"Currency code for the capital amount.\nExample: \"EUR\" for Euro\n","type":"string","enum":["EUR","DEM","USD"],"isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.capital.oneOf.0.currency","typeLabel":"enum\u003cstring>"},"start_date":{"description":"Date when this capital amount became effective.\nFormat: ISO 8601 (YYYY-MM-DD)\nExample: \"2023-01-01\"\n","type":"string","format":"date","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.capital.oneOf.0.start_date","typeLabel":"string\u003cdate>"}},"isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.capital.oneOf.0","typeLabel":"object"},{"type":"null","description":"Current registered capital of the company.\n","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.capital.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.capital","typeLabel":"object | null"},"capitals":{"description":"Historical capital changes.\nShows how the company capital changed over time.\n","type":"array","items":{"type":"object","properties":{"amount":{"description":"Capital amount as a decimal number.\nExample: 100000.00 represents 100,000.00 monetary units\n","type":"number","format":"double","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.capitals.items.[INDEX].amount","typeLabel":"number\u003cdouble>"},"currency":{"description":"Currency code for the capital amount.\nExample: \"EUR\" for Euro\n","type":"string","enum":["EUR","DEM","USD"],"isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.capitals.items.[INDEX].currency","typeLabel":"enum\u003cstring>"},"start_date":{"description":"Date when this capital amount became effective.\nFormat: ISO 8601 (YYYY-MM-DD)\nExample: \"2023-01-01\"\n","type":"string","format":"date","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.capitals.items.[INDEX].start_date","typeLabel":"string\u003cdate>"}},"required":["amount","currency","start_date"],"uniqueKey":"results.oneOf.0.company.oneOf.0.capitals.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.capitals","typeLabel":"object[]"},"representation":{"description":"List of individuals or entities authorized to represent the company.\nIncludes directors, officers, and authorized signatories.\n","type":"array","items":{"type":"object","properties":{"id":{"oneOf":[{"description":"Unique identifier for the representative.\nFor companies: Format matches company_id pattern\nFor individuals: UUID\nExample: \"DE-HRB-F1103-267645\" or UUID\nMay be null for certain representatives.\n","type":"string","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.representation.items.[INDEX].id.oneOf.0","typeLabel":"string"},{"description":"Unique identifier for the representative.\nFor companies: Format matches company_id pattern\nFor individuals: UUID\nExample: \"DE-HRB-F1103-267645\" or UUID\nMay be null for certain representatives.\n","type":"null","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.representation.items.[INDEX].id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.representation.items.[INDEX].id","typeLabel":"string | null"},"name":{"description":"The name of the representative. E.g. \"Max Mustermann\" or \"Max Mustermann GmbH\"","type":"string","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.representation.items.[INDEX].name","typeLabel":"string"},"type":{"type":"string","enum":["natural_person","legal_person"],"description":"Whether the representation is a natural person or a legal entity.","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.representation.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"role":{"description":"Coarse role bucket. Stable set of values, safe to switch on\nexhaustively. Use `role_detail` for the precise register role.\nE.g. \"DIRECTOR\"\n","type":"string","enum":["DIRECTOR","PROKURA","SHAREHOLDER","OWNER","PARTNER","PERSONAL_LIABLE_DIRECTOR","LIQUIDATOR","OTHER"],"isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.representation.items.[INDEX].role","typeLabel":"enum\u003cstring>"},"role_detail":{"description":"The precise role as recorded in the register, plus ready-to-display\ntitles. A Vorstand and a Geschäftsführer both have role \"DIRECTOR\"\nbut 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":"results.oneOf.0.company.oneOf.0.representation.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":"results.oneOf.0.company.oneOf.0.representation.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":"results.oneOf.0.company.oneOf.0.representation.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":"results.oneOf.0.company.oneOf.0.representation.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":"results.oneOf.0.company.oneOf.0.representation.items.[INDEX].role_detail.label_en_short","typeLabel":"string"}},"required":["code","label_de","label_de_short","label_en","label_en_short"],"isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.representation.items.[INDEX].role_detail","typeLabel":"object"},"start_date":{"description":"Date when this representative role became effective.\nFormat: ISO 8601 (YYYY-MM-DD)\nExample: \"2022-01-01\"\n","type":"string","format":"date","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.representation.items.[INDEX].start_date","typeLabel":"string\u003cdate>"},"end_date":{"oneOf":[{"description":"Date when this representative role ended (if applicable).\nFormat: ISO 8601 (YYYY-MM-DD)\nExample: \"2022-01-01\"\n","type":"string","format":"date","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.representation.items.[INDEX].end_date.oneOf.0","typeLabel":"string\u003cdate>"},{"description":"Date when this representative role ended (if applicable).\nFormat: ISO 8601 (YYYY-MM-DD)\nExample: \"2022-01-01\"\n","type":"null","format":"date","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.representation.items.[INDEX].end_date.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.representation.items.[INDEX].end_date","typeLabel":"string\u003cdate> | null"},"authority":{"oneOf":[{"description":"The representative's current individual representation authority\n(individuelle Vertretungsbefugnis), as published in the register.\nNull if no special authority is recorded.\nExample: \"einzelvertretungsberechtigt mit der Befugnis, im Namen der\nGesellschaft mit sich im eigenen Namen Rechtsgeschäfte abzuschließen\"\n","type":"string","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.representation.items.[INDEX].authority.oneOf.0","typeLabel":"string"},{"description":"The representative's current individual representation authority\n(individuelle Vertretungsbefugnis), as published in the register.\nNull if no special authority is recorded.\nExample: \"einzelvertretungsberechtigt mit der Befugnis, im Namen der\nGesellschaft mit sich im eigenen Namen Rechtsgeschäfte abzuschließen\"\n","type":"null","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.representation.items.[INDEX].authority.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.representation.items.[INDEX].authority","typeLabel":"string | null"},"authority_detail":{"oneOf":[{"type":"object","description":"Structured facts read from `authority`. Null when none are stated.","required":["type","self_dealing_allowed"],"properties":{"type":{"oneOf":[{"type":"string","description":"Signing authority. Null when not stated.","enum":["SOLE","JOINT","NONE","GENERAL"],"isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.representation.items.[INDEX].authority_detail.oneOf.0.type.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","description":"Signing authority. Null when not stated.","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.representation.items.[INDEX].authority_detail.oneOf.0.type.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.representation.items.[INDEX].authority_detail.oneOf.0.type","typeLabel":"enum\u003cstring> | null"},"self_dealing_allowed":{"oneOf":[{"description":"Fully exempt from self-dealing restrictions (in Germany § 181 BGB).\nNull when not stated or only partly exempt.\n","type":"boolean","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.representation.items.[INDEX].authority_detail.oneOf.0.self_dealing_allowed.oneOf.0","typeLabel":"boolean"},{"description":"Fully exempt from self-dealing restrictions (in Germany § 181 BGB).\nNull when not stated or only partly exempt.\n","type":"null","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.representation.items.[INDEX].authority_detail.oneOf.0.self_dealing_allowed.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.representation.items.[INDEX].authority_detail.oneOf.0.self_dealing_allowed","typeLabel":"boolean | null"}},"isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.representation.items.[INDEX].authority_detail.oneOf.0","typeLabel":"object"},{"type":"null","description":"Structured facts read from `authority`. Null when none are stated.","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.representation.items.[INDEX].authority_detail.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.representation.items.[INDEX].authority_detail","typeLabel":"object | null"},"legal_person":{"oneOf":[{"type":"object","required":["name","city","country"],"properties":{"name":{"type":"string","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.representation.items.[INDEX].legal_person.oneOf.0.name","typeLabel":"string"},"city":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.representation.items.[INDEX].legal_person.oneOf.0.city.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.representation.items.[INDEX].legal_person.oneOf.0.city.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.representation.items.[INDEX].legal_person.oneOf.0.city","typeLabel":"string | null"},"country":{"description":"Country where the representative is located, in ISO 3166-1 alpha-2 format.\nExample: \"DE\" for Germany\n","type":"string","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.representation.items.[INDEX].legal_person.oneOf.0.country","typeLabel":"string"}},"uniqueKey":"results.oneOf.0.company.oneOf.0.representation.items.[INDEX].legal_person.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"results.oneOf.0.company.oneOf.0.representation.items.[INDEX].legal_person.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.oneOf.0.company.oneOf.0.representation.items.[INDEX].legal_person","typeLabel":"object | null"},"natural_person":{"oneOf":[{"type":"object","required":["city","first_name","last_name","date_of_birth"],"properties":{"city":{"oneOf":[{"description":"City where the representative is located.\nExample: \"Berlin\"\n","type":"string","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.representation.items.[INDEX].natural_person.oneOf.0.city.oneOf.0","typeLabel":"string"},{"description":"City where the representative is located.\nExample: \"Berlin\"\n","type":"null","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.representation.items.[INDEX].natural_person.oneOf.0.city.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.representation.items.[INDEX].natural_person.oneOf.0.city","typeLabel":"string | null"},"first_name":{"oneOf":[{"description":"First name of the representative.\nExample: \"Max\"\n","type":"string","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.representation.items.[INDEX].natural_person.oneOf.0.first_name.oneOf.0","typeLabel":"string"},{"description":"First name of the representative.\nExample: \"Max\"\n","type":"null","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.representation.items.[INDEX].natural_person.oneOf.0.first_name.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.representation.items.[INDEX].natural_person.oneOf.0.first_name","typeLabel":"string | null"},"last_name":{"oneOf":[{"description":"Last name of the representative.\nExample: \"Mustermann\"\n","type":"string","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.representation.items.[INDEX].natural_person.oneOf.0.last_name.oneOf.0","typeLabel":"string"},{"description":"Last name of the representative.\nExample: \"Mustermann\"\n","type":"null","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.representation.items.[INDEX].natural_person.oneOf.0.last_name.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.representation.items.[INDEX].natural_person.oneOf.0.last_name","typeLabel":"string | null"},"date_of_birth":{"oneOf":[{"description":"Date of birth of the representative.\nMay still be null for natural persons if it is not available.\nFormat: ISO 8601 (YYYY-MM-DD)\nExample: \"1990-01-01\"\n","type":"string","format":"date","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.representation.items.[INDEX].natural_person.oneOf.0.date_of_birth.oneOf.0","typeLabel":"string\u003cdate>"},{"description":"Date of birth of the representative.\nMay still be null for natural persons if it is not available.\nFormat: ISO 8601 (YYYY-MM-DD)\nExample: \"1990-01-01\"\n","type":"null","format":"date","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.representation.items.[INDEX].natural_person.oneOf.0.date_of_birth.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.representation.items.[INDEX].natural_person.oneOf.0.date_of_birth","typeLabel":"string\u003cdate> | null"},"title":{"oneOf":[{"description":"Academic or professional title of the representative.\nExample: \"Dr.\"\n","type":"string","uniqueKey":"results.oneOf.0.company.oneOf.0.representation.items.[INDEX].natural_person.oneOf.0.title.oneOf.0","typeLabel":"string"},{"description":"Academic or professional title of the representative.\nExample: \"Dr.\"\n","type":"null","uniqueKey":"results.oneOf.0.company.oneOf.0.representation.items.[INDEX].natural_person.oneOf.0.title.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.oneOf.0.company.oneOf.0.representation.items.[INDEX].natural_person.oneOf.0.title","typeLabel":"string | null"}},"uniqueKey":"results.oneOf.0.company.oneOf.0.representation.items.[INDEX].natural_person.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"results.oneOf.0.company.oneOf.0.representation.items.[INDEX].natural_person.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.oneOf.0.company.oneOf.0.representation.items.[INDEX].natural_person","typeLabel":"object | null"}},"required":["id","name","type","role","role_detail","start_date","end_date","authority","authority_detail"],"uniqueKey":"results.oneOf.0.company.oneOf.0.representation.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.representation","typeLabel":"object[]"},"representation_rule":{"oneOf":[{"description":"The company's current general representation rule\n(allgemeine Vertretungsregelung), as published in the register.\nExample: \"Ist nur ein Geschäftsführer bestellt, so vertritt er die\nGesellschaft allein. Sind mehrere Geschäftsführer bestellt, so wird\ndie Gesellschaft durch zwei Geschäftsführer oder durch einen\nGeschäftsführer gemeinsam mit einem Prokuristen vertreten.\"\n","type":"string","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.representation_rule.oneOf.0","typeLabel":"string"},{"description":"The company's current general representation rule\n(allgemeine Vertretungsregelung), as published in the register.\nExample: \"Ist nur ein Geschäftsführer bestellt, so vertritt er die\nGesellschaft allein. Sind mehrere Geschäftsführer bestellt, so wird\ndie Gesellschaft durch zwei Geschäftsführer oder durch einen\nGeschäftsführer gemeinsam mit einem Prokuristen vertreten.\"\n","type":"null","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.representation_rule.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.representation_rule","typeLabel":"string | null"},"indicators":{"description":"Key company indicators like net income, employee count, revenue, etc..\n","type":"array","items":{"description":"A focused subset of the key company indicators for a given year.\nValues of the indicator are given in the smallest currency unit (cents).\nExample: 2099 represents €20.99 for monetary values.\nFor non-monetary values (e.g., employees), the actual number.\n","type":"object","properties":{"date":{"description":"Date to which this financial indicators apply.\nFormat: ISO 8601 (YYYY-MM-DD)\nExample: \"2022-01-01\"\n","type":"string","format":"date","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.indicators.items.[INDEX].date","typeLabel":"string\u003cdate>"},"report_id":{"description":"The report id (source) of the indicators.","type":"string","format":"uuid","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.indicators.items.[INDEX].report_id","typeLabel":"string\u003cuuid>"},"short_year":{"description":"A short fiscal year (Rumpfgeschäftsjahr), shorter than twelve months","type":"boolean","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.indicators.items.[INDEX].short_year","typeLabel":"boolean"},"balance_sheet_total":{"oneOf":[{"description":"The balance sheet total of that year (in cents).","type":"integer","format":"int64","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.indicators.items.[INDEX].balance_sheet_total.oneOf.0","typeLabel":"integer\u003cint64>"},{"description":"The balance sheet total of that year (in cents).","type":"null","format":"int64","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.indicators.items.[INDEX].balance_sheet_total.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.indicators.items.[INDEX].balance_sheet_total","typeLabel":"integer\u003cint64> | null"},"net_income":{"oneOf":[{"description":"The net income of that year (in cents).","type":"integer","format":"int64","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.indicators.items.[INDEX].net_income.oneOf.0","typeLabel":"integer\u003cint64>"},{"description":"The net income of that year (in cents).","type":"null","format":"int64","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.indicators.items.[INDEX].net_income.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.indicators.items.[INDEX].net_income","typeLabel":"integer\u003cint64> | null"},"revenue":{"oneOf":[{"description":"The revenue of that year (in cents).","type":"integer","format":"int64","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.indicators.items.[INDEX].revenue.oneOf.0","typeLabel":"integer\u003cint64>"},{"description":"The revenue of that year (in cents).","type":"null","format":"int64","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.indicators.items.[INDEX].revenue.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.indicators.items.[INDEX].revenue","typeLabel":"integer\u003cint64> | null"},"cash":{"oneOf":[{"description":"The cash of that year (in cents).","type":"integer","format":"int64","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.indicators.items.[INDEX].cash.oneOf.0","typeLabel":"integer\u003cint64>"},{"description":"The cash of that year (in cents).","type":"null","format":"int64","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.indicators.items.[INDEX].cash.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.indicators.items.[INDEX].cash","typeLabel":"integer\u003cint64> | null"},"employees":{"oneOf":[{"description":"The number of employees of that year.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.indicators.items.[INDEX].employees.oneOf.0","typeLabel":"integer\u003cint64>"},{"description":"The number of employees of that year.","type":"null","format":"int64","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.indicators.items.[INDEX].employees.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.indicators.items.[INDEX].employees","typeLabel":"integer\u003cint64> | null"},"equity":{"oneOf":[{"description":"The equity of that year (in cents).","type":"integer","format":"int64","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.indicators.items.[INDEX].equity.oneOf.0","typeLabel":"integer\u003cint64>"},{"description":"The equity of that year (in cents).","type":"null","format":"int64","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.indicators.items.[INDEX].equity.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.indicators.items.[INDEX].equity","typeLabel":"integer\u003cint64> | null"},"real_estate":{"oneOf":[{"description":"The real estate of that year (in cents).","type":"integer","format":"int64","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.indicators.items.[INDEX].real_estate.oneOf.0","typeLabel":"integer\u003cint64>"},{"description":"The real estate of that year (in cents).","type":"null","format":"int64","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.indicators.items.[INDEX].real_estate.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.indicators.items.[INDEX].real_estate","typeLabel":"integer\u003cint64> | null"},"materials":{"oneOf":[{"description":"The materials of that year (in cents).","type":"integer","format":"int64","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.indicators.items.[INDEX].materials.oneOf.0","typeLabel":"integer\u003cint64>"},{"description":"The materials of that year (in cents).","type":"null","format":"int64","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.indicators.items.[INDEX].materials.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.indicators.items.[INDEX].materials","typeLabel":"integer\u003cint64> | null"},"pension_provisions":{"oneOf":[{"description":"The pension provisions of that year (in cents).","type":"integer","format":"int64","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.indicators.items.[INDEX].pension_provisions.oneOf.0","typeLabel":"integer\u003cint64>"},{"description":"The pension provisions of that year (in cents).","type":"null","format":"int64","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.indicators.items.[INDEX].pension_provisions.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.indicators.items.[INDEX].pension_provisions","typeLabel":"integer\u003cint64> | null"},"salaries":{"oneOf":[{"description":"The salaries of that year (in cents).","type":"integer","format":"int64","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.indicators.items.[INDEX].salaries.oneOf.0","typeLabel":"integer\u003cint64>"},{"description":"The salaries of that year (in cents).","type":"null","format":"int64","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.indicators.items.[INDEX].salaries.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.indicators.items.[INDEX].salaries","typeLabel":"integer\u003cint64> | null"},"taxes":{"oneOf":[{"description":"The taxes of that year (in cents).","type":"integer","format":"int64","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.indicators.items.[INDEX].taxes.oneOf.0","typeLabel":"integer\u003cint64>"},{"description":"The taxes of that year (in cents).","type":"null","format":"int64","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.indicators.items.[INDEX].taxes.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.indicators.items.[INDEX].taxes","typeLabel":"integer\u003cint64> | null"},"liabilities":{"oneOf":[{"description":"The liabilities of that year (in cents).","type":"integer","format":"int64","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.indicators.items.[INDEX].liabilities.oneOf.0","typeLabel":"integer\u003cint64>"},{"description":"The liabilities of that year (in cents).","type":"null","format":"int64","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.indicators.items.[INDEX].liabilities.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.indicators.items.[INDEX].liabilities","typeLabel":"integer\u003cint64> | null"},"capital_reserves":{"oneOf":[{"description":"The capital reserves of that year (in cents).","type":"integer","format":"int64","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.indicators.items.[INDEX].capital_reserves.oneOf.0","typeLabel":"integer\u003cint64>"},{"description":"The capital reserves of that year (in cents).","type":"null","format":"int64","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.indicators.items.[INDEX].capital_reserves.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.indicators.items.[INDEX].capital_reserves","typeLabel":"integer\u003cint64> | null"}},"required":["date","report_id","short_year","balance_sheet_total","net_income","revenue","cash","employees","equity","real_estate","materials","pension_provisions","salaries","taxes","liabilities","capital_reserves"],"uniqueKey":"results.oneOf.0.company.oneOf.0.indicators.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.indicators","typeLabel":"object[]"},"legal_form":{"type":"string","description":"Legal form of the company.\nExample: \"gmbh\" for Gesellschaft mit beschränkter Haftung\n","enum":["ag","eg","ek","ev","ewiv","foreign","foundation","gbr","ggmbh","gmbh","kg","kgaa","unknown","llp","municipal","ohg","se","ug"],"isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.legal_form","typeLabel":"enum\u003cstring>"},"documents":{"description":"Available official documents related to the company.\n","type":"array","items":{"type":"object","properties":{"id":{"description":"Unique identifier for the document.\nExample: \"f47ac10b-58cc-4372-a567-0e02b2c3d479\"\n","type":"string","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.documents.items.[INDEX].id","typeLabel":"string"},"type":{"description":"Categorization of the document:\n- articles_of_association: Company statutes/bylaws\n- sample_protocol: Standard founding protocol\n- shareholder_list: List of company shareholders\n","type":"string","enum":["articles_of_association","sample_protocol","shareholder_list"],"isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.documents.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"date":{"description":"Document publication or filing date.\nFormat: ISO 8601 (YYYY-MM-DD)\nExample: \"2022-01-01\"\n","type":"string","format":"date","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.documents.items.[INDEX].date","typeLabel":"string\u003cdate>"},"latest":{"description":"Whether this is the latest version of the document_type.\n","type":"boolean","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.documents.items.[INDEX].latest","typeLabel":"boolean"}},"required":["id","type","date","latest"],"uniqueKey":"results.oneOf.0.company.oneOf.0.documents.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.documents","typeLabel":"object[]"},"incorporated_at":{"description":"Date when the company was officially registered.\nFormat: ISO 8601 (YYYY-MM-DD)\nExample: \"2022-01-01\"\n","type":"string","format":"date","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.incorporated_at","typeLabel":"string\u003cdate>"},"notarized_at":{"oneOf":[{"description":"Date of the notarized company agreement (Gesellschaftsvertrag or Satzung).\nFormat: ISO 8601 (YYYY-MM-DD)\nExample: \"2021-12-21\"\n","type":"string","format":"date","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.notarized_at.oneOf.0","typeLabel":"string\u003cdate>"},{"description":"Date of the notarized company agreement (Gesellschaftsvertrag or Satzung).\nFormat: ISO 8601 (YYYY-MM-DD)\nExample: \"2021-12-21\"\n","type":"null","format":"date","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.notarized_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.notarized_at","typeLabel":"string\u003cdate> | null"},"terminated_at":{"oneOf":[{"description":"Date when the company was officially terminated (if applicable).\nFormat: ISO 8601 (YYYY-MM-DD)\nExample: \"2024-01-01\"\n","type":"string","format":"date","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.terminated_at.oneOf.0","typeLabel":"string\u003cdate>"},{"description":"Date when the company was officially terminated (if applicable).\nFormat: ISO 8601 (YYYY-MM-DD)\nExample: \"2024-01-01\"\n","type":"null","format":"date","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.terminated_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.terminated_at","typeLabel":"string\u003cdate> | null"},"merged_into":{"oneOf":[{"type":"object","description":"If the company ceased to exist through a merger (Verschmelzung),\nthe company it was merged into.\n","required":["company_id","name","registration_date","agreement_date"],"properties":{"company_id":{"description":"Unique company identifier of the company this company was merged into.\nExample: DE-HRB-F1103-267645\n","type":"string","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.merged_into.oneOf.0.company_id","typeLabel":"string"},"name":{"description":"Current name of the company this company was merged into.\n","type":"string","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.merged_into.oneOf.0.name","typeLabel":"string"},"registration_date":{"description":"Date the merger was registered.\nFormat: ISO 8601 (YYYY-MM-DD)\n","type":"string","format":"date","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.merged_into.oneOf.0.registration_date","typeLabel":"string\u003cdate>"},"agreement_date":{"oneOf":[{"description":"Date the underlying contract (Verschmelzungsvertrag) was concluded,\nas cited in the register entry. Null when the register text does\nnot cite a contract date. Entries sharing an agreement_date belong\nto the same transaction.\nFormat: ISO 8601 (YYYY-MM-DD)\n","type":"string","format":"date","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.merged_into.oneOf.0.agreement_date.oneOf.0","typeLabel":"string\u003cdate>"},{"description":"Date the underlying contract (Verschmelzungsvertrag) was concluded,\nas cited in the register entry. Null when the register text does\nnot cite a contract date. Entries sharing an agreement_date belong\nto the same transaction.\nFormat: ISO 8601 (YYYY-MM-DD)\n","type":"null","format":"date","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.merged_into.oneOf.0.agreement_date.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.merged_into.oneOf.0.agreement_date","typeLabel":"string\u003cdate> | null"}},"isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.merged_into.oneOf.0","typeLabel":"object"},{"type":"null","description":"If the company ceased to exist through a merger (Verschmelzung),\nthe company it was merged into.\n","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.merged_into.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.merged_into","typeLabel":"object | null"},"acquisitions":{"description":"Companies that were merged into this company\n(Verschmelzung durch Aufnahme, as the acquiring entity).\n","type":"array","items":{"type":"object","properties":{"company_id":{"description":"Unique company identifier of the company that was merged into this company.\nExample: DE-HRB-F1103-267645\n","type":"string","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.acquisitions.items.[INDEX].company_id","typeLabel":"string"},"name":{"description":"Current name of the company that was merged into this company.\n","type":"string","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.acquisitions.items.[INDEX].name","typeLabel":"string"},"registration_date":{"description":"Date the merger was registered.\nFormat: ISO 8601 (YYYY-MM-DD)\n","type":"string","format":"date","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.acquisitions.items.[INDEX].registration_date","typeLabel":"string\u003cdate>"},"agreement_date":{"oneOf":[{"description":"Date the underlying contract (Verschmelzungsvertrag) was concluded,\nas cited in the register entry. Null when the register text does\nnot cite a contract date. Entries sharing an agreement_date belong\nto the same transaction.\nFormat: ISO 8601 (YYYY-MM-DD)\n","type":"string","format":"date","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.acquisitions.items.[INDEX].agreement_date.oneOf.0","typeLabel":"string\u003cdate>"},{"description":"Date the underlying contract (Verschmelzungsvertrag) was concluded,\nas cited in the register entry. Null when the register text does\nnot cite a contract date. Entries sharing an agreement_date belong\nto the same transaction.\nFormat: ISO 8601 (YYYY-MM-DD)\n","type":"null","format":"date","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.acquisitions.items.[INDEX].agreement_date.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.acquisitions.items.[INDEX].agreement_date","typeLabel":"string\u003cdate> | null"}},"required":["company_id","name","registration_date","agreement_date"],"uniqueKey":"results.oneOf.0.company.oneOf.0.acquisitions.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.acquisitions","typeLabel":"object[]"},"asset_spin_offs":{"description":"Spin-offs (Ausgliederung, § 123 Abs. 3 UmwG) in which this company\ntransferred assets to another company as the transferring entity.\n","type":"array","items":{"type":"object","properties":{"company_id":{"description":"Unique company identifier of the company that received the assets.\nExample: DE-HRB-F1103-267645\n","type":"string","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.asset_spin_offs.items.[INDEX].company_id","typeLabel":"string"},"name":{"description":"Current name of the company that received the assets.\n","type":"string","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.asset_spin_offs.items.[INDEX].name","typeLabel":"string"},"registration_date":{"description":"Date the spin-off was registered.\nFormat: ISO 8601 (YYYY-MM-DD)\n","type":"string","format":"date","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.asset_spin_offs.items.[INDEX].registration_date","typeLabel":"string\u003cdate>"},"agreement_date":{"oneOf":[{"description":"Date the underlying contract (Ausgliederungsvertrag) was concluded,\nas cited in the register entry. Null when the register text does\nnot cite a contract date. Entries sharing an agreement_date belong\nto the same transaction.\nFormat: ISO 8601 (YYYY-MM-DD)\n","type":"string","format":"date","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.asset_spin_offs.items.[INDEX].agreement_date.oneOf.0","typeLabel":"string\u003cdate>"},{"description":"Date the underlying contract (Ausgliederungsvertrag) was concluded,\nas cited in the register entry. Null when the register text does\nnot cite a contract date. Entries sharing an agreement_date belong\nto the same transaction.\nFormat: ISO 8601 (YYYY-MM-DD)\n","type":"null","format":"date","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.asset_spin_offs.items.[INDEX].agreement_date.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.asset_spin_offs.items.[INDEX].agreement_date","typeLabel":"string\u003cdate> | null"}},"required":["company_id","name","registration_date","agreement_date"],"uniqueKey":"results.oneOf.0.company.oneOf.0.asset_spin_offs.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.asset_spin_offs","typeLabel":"object[]"},"profit_transfer_agreement":{"oneOf":[{"type":"object","description":"The company's current profit and loss transfer agreement\n(Gewinnabführungsvertrag), if one exists. The referenced company\nis the parent receiving this company's profit (Organträger).\nNull if the company has no active agreement.\n","required":["company_id","name","registration_date","agreement_date"],"properties":{"company_id":{"description":"Unique company identifier of the parent company receiving\nthis company's profit (Organträger).\nExample: DE-HRB-F1103-267645\n","type":"string","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.profit_transfer_agreement.oneOf.0.company_id","typeLabel":"string"},"name":{"description":"Current name of the parent company.\n","type":"string","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.profit_transfer_agreement.oneOf.0.name","typeLabel":"string"},"registration_date":{"description":"Date the agreement was registered.\nFormat: ISO 8601 (YYYY-MM-DD)\n","type":"string","format":"date","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.profit_transfer_agreement.oneOf.0.registration_date","typeLabel":"string\u003cdate>"},"agreement_date":{"oneOf":[{"description":"Date the underlying contract (Gewinnabführungsvertrag) was concluded,\nas cited in the register entry. Null when the register text does\nnot cite a contract date. Entries sharing an agreement_date belong\nto the same transaction.\nFormat: ISO 8601 (YYYY-MM-DD)\n","type":"string","format":"date","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.profit_transfer_agreement.oneOf.0.agreement_date.oneOf.0","typeLabel":"string\u003cdate>"},{"description":"Date the underlying contract (Gewinnabführungsvertrag) was concluded,\nas cited in the register entry. Null when the register text does\nnot cite a contract date. Entries sharing an agreement_date belong\nto the same transaction.\nFormat: ISO 8601 (YYYY-MM-DD)\n","type":"null","format":"date","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.profit_transfer_agreement.oneOf.0.agreement_date.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.profit_transfer_agreement.oneOf.0.agreement_date","typeLabel":"string\u003cdate> | null"}},"isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.profit_transfer_agreement.oneOf.0","typeLabel":"object"},{"type":"null","description":"The company's current profit and loss transfer agreement\n(Gewinnabführungsvertrag), if one exists. The referenced company\nis the parent receiving this company's profit (Organträger).\nNull if the company has no active agreement.\n","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.profit_transfer_agreement.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.profit_transfer_agreement","typeLabel":"object | null"},"industry_codes":{"description":"Industry codes of the company, classified from its current\npurpose (Unternehmensgegenstand). Empty when the purpose has not\nbeen classified or describes no codable activity.\n","type":"object","properties":{"WZ2025":{"type":"array","items":{"type":"object","description":"A WZ 2025 class (Klasse) the company is active in, with the\nsubclasses (Unterklassen) behind it. The class of the company's main\nactivity comes first.\n","properties":{"code":{"type":"string","description":"WZ 2025 class.\nExample: \"64.19\"\n","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.industry_codes.WZ2025.items.[INDEX].code","typeLabel":"string"},"label_de":{"type":"string","description":"Official German title of the class.\nExample: \"Kreditinstitute, ohne Spezialkreditinstitute\"\n","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.industry_codes.WZ2025.items.[INDEX].label_de","typeLabel":"string"},"primary":{"type":"boolean","description":"Whether the company's main activity falls in this class. True for\nat most one class. The main activity is classified from the\npurpose, not recorded in the register.\n","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.industry_codes.WZ2025.items.[INDEX].primary","typeLabel":"boolean"},"subclasses":{"type":"array","description":"The WZ 2025 subclasses within this class, the main activity first.\n","items":{"type":"object","description":"A WZ 2025 subclass (Unterklasse).\n","properties":{"code":{"type":"string","description":"WZ 2025 subclass.\nExample: \"64.19.1\"\n","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.industry_codes.WZ2025.items.[INDEX].subclasses.items.[INDEX].code","typeLabel":"string"},"label_de":{"type":"string","description":"Official German title of the subclass.\nExample: \"Kreditbanken einschließlich Zweigstellen ausländischer Banken\"\n","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.industry_codes.WZ2025.items.[INDEX].subclasses.items.[INDEX].label_de","typeLabel":"string"},"primary":{"type":"boolean","description":"Whether this is the company's main activity. True for at most one\nsubclass. The main activity is classified from the purpose, not\nrecorded in the register.\n","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.industry_codes.WZ2025.items.[INDEX].subclasses.items.[INDEX].primary","typeLabel":"boolean"}},"required":["code","label_de","primary"],"uniqueKey":"results.oneOf.0.company.oneOf.0.industry_codes.WZ2025.items.[INDEX].subclasses.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.industry_codes.WZ2025.items.[INDEX].subclasses","typeLabel":"object[]"}},"required":["code","label_de","primary","subclasses"],"uniqueKey":"results.oneOf.0.company.oneOf.0.industry_codes.WZ2025.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.industry_codes.WZ2025","typeLabel":"object[]"}},"required":["WZ2025"],"isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.industry_codes","typeLabel":"object"},"contact":{"oneOf":[{"type":"object","description":"Contact information of the company.\n","required":["website_url","social_media"],"properties":{"website_url":{"type":"string","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.contact.oneOf.0.website_url","typeLabel":"string"},"social_media":{"type":"object","properties":{"linkedin":{"type":"string","uniqueKey":"results.oneOf.0.company.oneOf.0.contact.oneOf.0.social_media.linkedin","typeLabel":"string"},"instagram":{"type":"string","uniqueKey":"results.oneOf.0.company.oneOf.0.contact.oneOf.0.social_media.instagram","typeLabel":"string"},"github":{"type":"string","uniqueKey":"results.oneOf.0.company.oneOf.0.contact.oneOf.0.social_media.github","typeLabel":"string"},"twitter":{"type":"string","uniqueKey":"results.oneOf.0.company.oneOf.0.contact.oneOf.0.social_media.twitter","typeLabel":"string"},"facebook":{"type":"string","uniqueKey":"results.oneOf.0.company.oneOf.0.contact.oneOf.0.social_media.facebook","typeLabel":"string"},"youtube":{"type":"string","uniqueKey":"results.oneOf.0.company.oneOf.0.contact.oneOf.0.social_media.youtube","typeLabel":"string"},"xing":{"type":"string","uniqueKey":"results.oneOf.0.company.oneOf.0.contact.oneOf.0.social_media.xing","typeLabel":"string"},"tiktok":{"type":"string","uniqueKey":"results.oneOf.0.company.oneOf.0.contact.oneOf.0.social_media.tiktok","typeLabel":"string"}},"isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.contact.oneOf.0.social_media","typeLabel":"object"},"email":{"type":"string","uniqueKey":"results.oneOf.0.company.oneOf.0.contact.oneOf.0.email","typeLabel":"string"},"phone":{"type":"string","uniqueKey":"results.oneOf.0.company.oneOf.0.contact.oneOf.0.phone","typeLabel":"string"},"vat_id":{"type":"string","uniqueKey":"results.oneOf.0.company.oneOf.0.contact.oneOf.0.vat_id","typeLabel":"string"}},"isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.contact.oneOf.0","typeLabel":"object"},{"type":"null","description":"Contact information of the company.\n","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.contact.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.contact","typeLabel":"object | null"},"estimates":{"type":"object","description":"Modelled revenue, EBITDA and employees for companies that do not\nreport them. One estimate per metric, for the latest fiscal year.\n","properties":{"revenue":{"oneOf":[{"type":"object","description":"Estimated revenue (in cents).","required":["value","min","max","confidence","date"],"properties":{"value":{"description":"The estimated figure, the middle of the modelled range.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.estimates.revenue.oneOf.0.value","typeLabel":"integer\u003cint64>"},"min":{"description":"Lower end of the 80% range.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.estimates.revenue.oneOf.0.min","typeLabel":"integer\u003cint64>"},"max":{"description":"Upper end of the 80% range.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.estimates.revenue.oneOf.0.max","typeLabel":"integer\u003cint64>"},"confidence":{"description":"How narrow the 80% range is, the same tiers the search filters\nestimated_*_confidence use. Revenue and employees are judged by\nthe ratio of max to min, EBITDA by the range relative to the\nlatest reported balance sheet total (low when there is none).\n","type":"string","enum":["high","medium","low"],"isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.estimates.revenue.oneOf.0.confidence","typeLabel":"enum\u003cstring>"},"date":{"description":"End of the fiscal year the estimate applies to, matching the\ncompany's reporting year end.\nFormat: ISO 8601 (YYYY-MM-DD)\nExample: \"2024-12-31\"\n","type":"string","format":"date","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.estimates.revenue.oneOf.0.date","typeLabel":"string\u003cdate>"}},"isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.estimates.revenue.oneOf.0","typeLabel":"object"},{"type":"null","description":"Estimated revenue (in cents).","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.estimates.revenue.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.estimates.revenue","typeLabel":"object | null"},"ebitda":{"oneOf":[{"type":"object","description":"Estimated EBITDA (in cents).","required":["value","min","max","confidence","date"],"properties":{"value":{"description":"The estimated figure, the middle of the modelled range.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.estimates.ebitda.oneOf.0.value","typeLabel":"integer\u003cint64>"},"min":{"description":"Lower end of the 80% range.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.estimates.ebitda.oneOf.0.min","typeLabel":"integer\u003cint64>"},"max":{"description":"Upper end of the 80% range.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.estimates.ebitda.oneOf.0.max","typeLabel":"integer\u003cint64>"},"confidence":{"description":"How narrow the 80% range is, the same tiers the search filters\nestimated_*_confidence use. Revenue and employees are judged by\nthe ratio of max to min, EBITDA by the range relative to the\nlatest reported balance sheet total (low when there is none).\n","type":"string","enum":["high","medium","low"],"isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.estimates.ebitda.oneOf.0.confidence","typeLabel":"enum\u003cstring>"},"date":{"description":"End of the fiscal year the estimate applies to, matching the\ncompany's reporting year end.\nFormat: ISO 8601 (YYYY-MM-DD)\nExample: \"2024-12-31\"\n","type":"string","format":"date","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.estimates.ebitda.oneOf.0.date","typeLabel":"string\u003cdate>"}},"isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.estimates.ebitda.oneOf.0","typeLabel":"object"},{"type":"null","description":"Estimated EBITDA (in cents).","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.estimates.ebitda.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.estimates.ebitda","typeLabel":"object | null"},"employees":{"oneOf":[{"type":"object","description":"Estimated number of employees.","required":["value","min","max","confidence","date"],"properties":{"value":{"description":"The estimated figure, the middle of the modelled range.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.estimates.employees.oneOf.0.value","typeLabel":"integer\u003cint64>"},"min":{"description":"Lower end of the 80% range.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.estimates.employees.oneOf.0.min","typeLabel":"integer\u003cint64>"},"max":{"description":"Upper end of the 80% range.","type":"integer","format":"int64","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.estimates.employees.oneOf.0.max","typeLabel":"integer\u003cint64>"},"confidence":{"description":"How narrow the 80% range is, the same tiers the search filters\nestimated_*_confidence use. Revenue and employees are judged by\nthe ratio of max to min, EBITDA by the range relative to the\nlatest reported balance sheet total (low when there is none).\n","type":"string","enum":["high","medium","low"],"isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.estimates.employees.oneOf.0.confidence","typeLabel":"enum\u003cstring>"},"date":{"description":"End of the fiscal year the estimate applies to, matching the\ncompany's reporting year end.\nFormat: ISO 8601 (YYYY-MM-DD)\nExample: \"2024-12-31\"\n","type":"string","format":"date","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.estimates.employees.oneOf.0.date","typeLabel":"string\u003cdate>"}},"isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.estimates.employees.oneOf.0","typeLabel":"object"},{"type":"null","description":"Estimated number of employees.","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.estimates.employees.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.estimates.employees","typeLabel":"object | null"}},"required":["revenue","ebitda","employees"],"isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.estimates","typeLabel":"object"},"sources":{"description":"Sources of the company data.\n","type":"array","items":{"type":"object","properties":{"document_url":{"description":"Url of the source document. In the form of a presigned url accessible for 30 minutes.\n","type":"string","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.sources.items.[INDEX].document_url","typeLabel":"string"}},"required":["document_url"],"uniqueKey":"results.oneOf.0.company.oneOf.0.sources.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.sources","typeLabel":"object[]"},"lei":{"description":"Legal Entity Identifier (LEI), if available.\n","type":"string","uniqueKey":"results.oneOf.0.company.oneOf.0.lei","typeLabel":"string"},"insolvencies":{"description":"Insolvency proceedings of the company, if any.\nContains basic information per proceeding; use the insolvency\nendpoint to retrieve all events of a proceeding.\n","type":"array","items":{"type":"object","description":"Basic information about an insolvency proceeding of the company.\nUse the insolvency endpoint to retrieve all events of the proceeding.\n","properties":{"id":{"description":"Unique identifier of the insolvency proceeding.\n","type":"string","format":"uuid","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.insolvencies.items.[INDEX].id","typeLabel":"string\u003cuuid>"},"current_status":{"type":"string","description":"Current status of the insolvency proceeding.\n","enum":["preliminary","opened","rejected_no_assets","mass_insufficient","plan_supervised","lifted","discontinued","discharge_pending","discharge_granted","discharge_denied","discharge_revoked","unknown"],"isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.insolvencies.items.[INDEX].current_status","typeLabel":"enum\u003cstring>"},"court":{"description":"Insolvency court handling the proceeding.\n","type":"string","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.insolvencies.items.[INDEX].court","typeLabel":"string"},"case_number":{"description":"Case number of the proceeding at the court.\nExample: \"36d IN 3382/25\"\n","type":"string","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0.insolvencies.items.[INDEX].case_number","typeLabel":"string"},"proceeding_kind":{"oneOf":[{"type":"string","description":"Kind of insolvency proceeding. Null when unknown.\n","enum":["regular_insolvency","consumer_insolvency"],"uniqueKey":"results.oneOf.0.company.oneOf.0.insolvencies.items.[INDEX].proceeding_kind.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","description":"Kind of insolvency proceeding. Null when unknown.\n","uniqueKey":"results.oneOf.0.company.oneOf.0.insolvencies.items.[INDEX].proceeding_kind.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.oneOf.0.company.oneOf.0.insolvencies.items.[INDEX].proceeding_kind","typeLabel":"enum\u003cstring> | null"},"administration_kind":{"oneOf":[{"type":"string","description":"Kind of administration ordered for the proceeding. Null when unknown.\n","enum":["external_administration","self_administration","protective_shield"],"uniqueKey":"results.oneOf.0.company.oneOf.0.insolvencies.items.[INDEX].administration_kind.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","description":"Kind of administration ordered for the proceeding. Null when unknown.\n","uniqueKey":"results.oneOf.0.company.oneOf.0.insolvencies.items.[INDEX].administration_kind.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.oneOf.0.company.oneOf.0.insolvencies.items.[INDEX].administration_kind","typeLabel":"enum\u003cstring> | null"},"opened_at":{"oneOf":[{"description":"Date the proceeding was opened.\nFormat: ISO 8601 (YYYY-MM-DD)\n","type":"string","format":"date","uniqueKey":"results.oneOf.0.company.oneOf.0.insolvencies.items.[INDEX].opened_at.oneOf.0","typeLabel":"string\u003cdate>"},{"description":"Date the proceeding was opened.\nFormat: ISO 8601 (YYYY-MM-DD)\n","type":"null","format":"date","uniqueKey":"results.oneOf.0.company.oneOf.0.insolvencies.items.[INDEX].opened_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.oneOf.0.company.oneOf.0.insolvencies.items.[INDEX].opened_at","typeLabel":"string\u003cdate> | null"},"closed_at":{"oneOf":[{"description":"Date the proceeding was closed.\nFormat: ISO 8601 (YYYY-MM-DD)\n","type":"string","format":"date","uniqueKey":"results.oneOf.0.company.oneOf.0.insolvencies.items.[INDEX].closed_at.oneOf.0","typeLabel":"string\u003cdate>"},{"description":"Date the proceeding was closed.\nFormat: ISO 8601 (YYYY-MM-DD)\n","type":"null","format":"date","uniqueKey":"results.oneOf.0.company.oneOf.0.insolvencies.items.[INDEX].closed_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.oneOf.0.company.oneOf.0.insolvencies.items.[INDEX].closed_at","typeLabel":"string\u003cdate> | null"}},"required":["id","current_status","court","case_number"],"uniqueKey":"results.oneOf.0.company.oneOf.0.insolvencies.items.[INDEX]","typeLabel":"object"},"uniqueKey":"results.oneOf.0.company.oneOf.0.insolvencies","typeLabel":"object[]"}},"isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.0","typeLabel":"object"},{"type":"null","isRequired":true,"uniqueKey":"results.oneOf.0.company.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"results.oneOf.0.company","typeLabel":"object | null"},"owners":{"oneOf":[{"type":"object","description":"The refreshed owners of an `owners` job.","required":["company_id","owners","sources","best_available"],"properties":{"company_id":{"type":"string","description":"Unique company identifier.\nExample: DE-HRB-F1103-267645\n","isRequired":true,"uniqueKey":"results.oneOf.0.owners.oneOf.0.company_id","typeLabel":"string"},"owners":{"type":"array","items":{"type":"object","properties":{"id":{"oneOf":[{"description":"Unique identifier for the shareholder.\nFor companies: Format matches company_id pattern\nFor individuals: UUID\nExample: \"DE-HRB-F1103-267645\" or UUID\nMay be null for certain shareholders.\n","type":"string","isRequired":true,"uniqueKey":"results.oneOf.0.owners.oneOf.0.owners.items.[INDEX].id.oneOf.0","typeLabel":"string"},{"description":"Unique identifier for the shareholder.\nFor companies: Format matches company_id pattern\nFor individuals: UUID\nExample: \"DE-HRB-F1103-267645\" or UUID\nMay be null for certain shareholders.\n","type":"null","isRequired":true,"uniqueKey":"results.oneOf.0.owners.oneOf.0.owners.items.[INDEX].id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"results.oneOf.0.owners.oneOf.0.owners.items.[INDEX].id","typeLabel":"string | null"},"type":{"type":"string","enum":["natural_person","legal_person"],"description":"The type of shareholder.","isRequired":true,"uniqueKey":"results.oneOf.0.owners.oneOf.0.owners.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"relation_type":{"type":"string","enum":["shareholder","stockholder","limited_partner","general_partner"],"description":"Type of relationship between the entity and the company.\nUse `role_detail` for the precise register role.\n","isRequired":true,"uniqueKey":"results.oneOf.0.owners.oneOf.0.owners.items.[INDEX].relation_type","typeLabel":"enum\u003cstring>"},"role_detail":{"description":"The precise role as recorded in the register, plus ready-to-display\ntitles. A Kommanditist and a Gesellschafter both appear here with\ntheir register-level role, while `relation_type` only carries the\ncoarse bucket.\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":"results.oneOf.0.owners.oneOf.0.owners.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":"results.oneOf.0.owners.oneOf.0.owners.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":"results.oneOf.0.owners.oneOf.0.owners.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":"results.oneOf.0.owners.oneOf.0.owners.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":"results.oneOf.0.owners.oneOf.0.owners.items.[INDEX].role_detail.label_en_short","typeLabel":"string"}},"required":["code","label_de","label_de_short","label_en","label_en_short"],"isRequired":true,"uniqueKey":"results.oneOf.0.owners.oneOf.0.owners.items.[INDEX].role_detail","typeLabel":"object"},"name":{"description":"The name of the shareholder. E.g. \"Max Mustermann\" or \"Max Mustermann GmbH\"","type":"string","isRequired":true,"uniqueKey":"results.oneOf.0.owners.oneOf.0.owners.items.[INDEX].name","typeLabel":"string"},"natural_person":{"oneOf":[{"type":"object","description":"Details about the natural person.\n","required":["full_name","first_name","last_name","date_of_birth","city","country"],"properties":{"full_name":{"type":"string","isRequired":true,"uniqueKey":"results.oneOf.0.owners.oneOf.0.owners.items.[INDEX].natural_person.oneOf.0.full_name","typeLabel":"string"},"first_name":{"type":"string","isRequired":true,"uniqueKey":"results.oneOf.0.owners.oneOf.0.owners.items.[INDEX].natural_person.oneOf.0.first_name","typeLabel":"string"},"last_name":{"type":"string","isRequired":true,"uniqueKey":"results.oneOf.0.owners.oneOf.0.owners.items.[INDEX].natural_person.oneOf.0.last_name","typeLabel":"string"},"date_of_birth":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"results.oneOf.0.owners.oneOf.0.owners.items.[INDEX].natural_person.oneOf.0.date_of_birth.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"results.oneOf.0.owners.oneOf.0.owners.items.[INDEX].natural_person.oneOf.0.date_of_birth.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"results.oneOf.0.owners.oneOf.0.owners.items.[INDEX].natural_person.oneOf.0.date_of_birth","typeLabel":"string | null"},"city":{"type":"string","isRequired":true,"uniqueKey":"results.oneOf.0.owners.oneOf.0.owners.items.[INDEX].natural_person.oneOf.0.city","typeLabel":"string"},"country":{"type":"string","isRequired":true,"uniqueKey":"results.oneOf.0.owners.oneOf.0.owners.items.[INDEX].natural_person.oneOf.0.country","typeLabel":"string"}},"isRequired":true,"uniqueKey":"results.oneOf.0.owners.oneOf.0.owners.items.[INDEX].natural_person.oneOf.0","typeLabel":"object"},{"type":"null","description":"Details about the natural person.\n","isRequired":true,"uniqueKey":"results.oneOf.0.owners.oneOf.0.owners.items.[INDEX].natural_person.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"results.oneOf.0.owners.oneOf.0.owners.items.[INDEX].natural_person","typeLabel":"object | null"},"legal_person":{"oneOf":[{"type":"object","description":"Details about the legal person.\n","required":["name","city","country"],"properties":{"name":{"type":"string","isRequired":true,"uniqueKey":"results.oneOf.0.owners.oneOf.0.owners.items.[INDEX].legal_person.oneOf.0.name","typeLabel":"string"},"city":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"results.oneOf.0.owners.oneOf.0.owners.items.[INDEX].legal_person.oneOf.0.city.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"results.oneOf.0.owners.oneOf.0.owners.items.[INDEX].legal_person.oneOf.0.city.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"results.oneOf.0.owners.oneOf.0.owners.items.[INDEX].legal_person.oneOf.0.city","typeLabel":"string | null"},"country":{"description":"Country where the owner is located, in ISO 3166-1 alpha-2 format.\nExample: \"DE\" for Germany\n","type":"string","isRequired":true,"uniqueKey":"results.oneOf.0.owners.oneOf.0.owners.items.[INDEX].legal_person.oneOf.0.country","typeLabel":"string"}},"isRequired":true,"uniqueKey":"results.oneOf.0.owners.oneOf.0.owners.items.[INDEX].legal_person.oneOf.0","typeLabel":"object"},{"type":"null","description":"Details about the legal person.\n","isRequired":true,"uniqueKey":"results.oneOf.0.owners.oneOf.0.owners.items.[INDEX].legal_person.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"results.oneOf.0.owners.oneOf.0.owners.items.[INDEX].legal_person","typeLabel":"object | null"},"nominal_share":{"description":"Nominal value of shares in Euro.\nExample: 100\n","type":"number","format":"double","isRequired":true,"uniqueKey":"results.oneOf.0.owners.oneOf.0.owners.items.[INDEX].nominal_share","typeLabel":"number\u003cdouble>"},"percentage_share":{"oneOf":[{"description":"Percentage of company ownership.\nExample: 5.36 represents 5.36% ownership\n","type":"number","format":"double","isRequired":true,"uniqueKey":"results.oneOf.0.owners.oneOf.0.owners.items.[INDEX].percentage_share.oneOf.0","typeLabel":"number\u003cdouble>"},{"description":"Percentage of company ownership.\nExample: 5.36 represents 5.36% ownership\n","type":"null","format":"double","isRequired":true,"uniqueKey":"results.oneOf.0.owners.oneOf.0.owners.items.[INDEX].percentage_share.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"results.oneOf.0.owners.oneOf.0.owners.items.[INDEX].percentage_share","typeLabel":"number\u003cdouble> | null"},"start":{"oneOf":[{"description":"Date when the relation started. Only available for some types of owners.\nFormat: ISO 8601 (YYYY-MM-DD)\nExample: \"2022-01-01\"\n","type":"string","format":"date","isRequired":true,"uniqueKey":"results.oneOf.0.owners.oneOf.0.owners.items.[INDEX].start.oneOf.0","typeLabel":"string\u003cdate>"},{"description":"Date when the relation started. Only available for some types of owners.\nFormat: ISO 8601 (YYYY-MM-DD)\nExample: \"2022-01-01\"\n","type":"null","format":"date","isRequired":true,"uniqueKey":"results.oneOf.0.owners.oneOf.0.owners.items.[INDEX].start.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"results.oneOf.0.owners.oneOf.0.owners.items.[INDEX].start","typeLabel":"string\u003cdate> | null"}},"required":["id","type","relation_type","role_detail","name","natural_person","legal_person","nominal_share","percentage_share","start"],"uniqueKey":"results.oneOf.0.owners.oneOf.0.owners.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"results.oneOf.0.owners.oneOf.0.owners","typeLabel":"object[]"},"sources":{"description":"Sources of the company owners data.\n","type":"array","items":{"type":"object","properties":{"document_url":{"description":"Url of the source document. In the form of a presigned url accessible for 30 minutes.\n","type":"string","isRequired":true,"uniqueKey":"results.oneOf.0.owners.oneOf.0.sources.items.[INDEX].document_url","typeLabel":"string"}},"required":["document_url"],"uniqueKey":"results.oneOf.0.owners.oneOf.0.sources.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"results.oneOf.0.owners.oneOf.0.sources","typeLabel":"object[]"},"best_available":{"type":"boolean","description":"When true, the returned owner data is the best available but may not reflect\nthe most current ownership state. This applies to AG and SE companies where\nownership data is sourced from Handelsregister decision and articles of\nassociation documents, which are not filed on every ownership change.\n","isRequired":true,"uniqueKey":"results.oneOf.0.owners.oneOf.0.best_available","typeLabel":"boolean"}},"isRequired":true,"uniqueKey":"results.oneOf.0.owners.oneOf.0","typeLabel":"object"},{"type":"null","isRequired":true,"uniqueKey":"results.oneOf.0.owners.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"results.oneOf.0.owners","typeLabel":"object | null"}},"isRequired":true,"uniqueKey":"results.oneOf.0","typeLabel":"object"},{"type":"null","isRequired":true,"uniqueKey":"results.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"results","typeLabel":"object | null"},"expires_at":{"oneOf":[{"type":"string","format":"date-time","description":"Until when a completed job returns `results`, 12 hours after it finished.","isRequired":true,"uniqueKey":"expires_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","description":"Until when a completed job returns `results`, 12 hours after it finished.","isRequired":true,"uniqueKey":"expires_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"expires_at","typeLabel":"string\u003cdate-time> | null"},"created_at":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"created_at","typeLabel":"string\u003cdate-time>"},"finished_at":{"oneOf":[{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"finished_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","isRequired":true,"uniqueKey":"finished_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"finished_at","typeLabel":"string\u003cdate-time> | null"}},"required":["id","type","company_id","document_category","status","reason","results","expires_at","created_at","finished_at"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","type":"company","company_id":"\u003cstring>","document_category":"current_printout","status":"pending","reason":"not_available","results":{"document":{"url":"\u003cstring>","file_date":"2023-12-25","file_name":"\u003cstring>"},"company":{"id":"\u003cstring>","register":{"register_number":"\u003cstring>","register_type":"HRB","register_court":"\u003cstring>","company_id":"\u003cstring>","start_date":"2023-12-25"},"registers":[{"register_number":"\u003cstring>","register_type":"HRB","register_court":"\u003cstring>","company_id":"\u003cstring>","start_date":"2023-12-25"}],"status":"active","name":{"name":"\u003cstring>","legal_form":"ag","start_date":"2023-12-25"},"names":[{"name":"\u003cstring>","legal_form":"ag","start_date":"2023-12-25"}],"address":{"city":"\u003cstring>","country":"\u003cstring>","start_date":"2023-12-25","formatted_value":"\u003cstring>","street":"\u003cstring>","postal_code":"\u003cstring>","extra":"\u003cstring>"},"addresses":[{"city":"\u003cstring>","country":"\u003cstring>","start_date":"2023-12-25","formatted_value":"\u003cstring>","street":"\u003cstring>","postal_code":"\u003cstring>","extra":"\u003cstring>"}],"purpose":{"purpose":"\u003cstring>","start_date":"2023-12-25"},"purposes":[{"purpose":"\u003cstring>","start_date":"2023-12-25"}],"capital":{"amount":123,"currency":"EUR","start_date":"2023-12-25"},"capitals":[{"amount":123,"currency":"EUR","start_date":"2023-12-25"}],"representation":[{"id":"\u003cstring>","name":"\u003cstring>","type":"natural_person","role":"DIRECTOR","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","authority":"\u003cstring>","authority_detail":{"type":"SOLE","self_dealing_allowed":true},"legal_person":{"name":"\u003cstring>","city":"\u003cstring>","country":"\u003cstring>"},"natural_person":{"city":"\u003cstring>","first_name":"\u003cstring>","last_name":"\u003cstring>","date_of_birth":"2023-12-25","title":"\u003cstring>"}}],"representation_rule":"\u003cstring>","indicators":[{"date":"2023-12-25","report_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","short_year":true,"balance_sheet_total":123,"net_income":123,"revenue":123,"cash":123,"employees":123,"equity":123,"real_estate":123,"materials":123,"pension_provisions":123,"salaries":123,"taxes":123,"liabilities":123,"capital_reserves":123}],"legal_form":"ag","documents":[{"id":"\u003cstring>","type":"articles_of_association","date":"2023-12-25","latest":true}],"incorporated_at":"2023-12-25","notarized_at":"2023-12-25","terminated_at":"2023-12-25","merged_into":{"company_id":"\u003cstring>","name":"\u003cstring>","registration_date":"2023-12-25","agreement_date":"2023-12-25"},"acquisitions":[{"company_id":"\u003cstring>","name":"\u003cstring>","registration_date":"2023-12-25","agreement_date":"2023-12-25"}],"asset_spin_offs":[{"company_id":"\u003cstring>","name":"\u003cstring>","registration_date":"2023-12-25","agreement_date":"2023-12-25"}],"profit_transfer_agreement":{"company_id":"\u003cstring>","name":"\u003cstring>","registration_date":"2023-12-25","agreement_date":"2023-12-25"},"industry_codes":{"WZ2025":[{"code":"\u003cstring>","label_de":"\u003cstring>","primary":true,"subclasses":[{"code":"\u003cstring>","label_de":"\u003cstring>","primary":true}]}]},"contact":{"website_url":"\u003cstring>","social_media":{"linkedin":"\u003cstring>","instagram":"\u003cstring>","github":"\u003cstring>","twitter":"\u003cstring>","facebook":"\u003cstring>","youtube":"\u003cstring>","xing":"\u003cstring>","tiktok":"\u003cstring>"},"email":"\u003cstring>","phone":"\u003cstring>","vat_id":"\u003cstring>"},"estimates":{"revenue":{"value":123,"min":123,"max":123,"confidence":"high","date":"2023-12-25"},"ebitda":{"value":123,"min":123,"max":123,"confidence":"high","date":"2023-12-25"},"employees":{"value":123,"min":123,"max":123,"confidence":"high","date":"2023-12-25"}},"sources":[{"document_url":"\u003cstring>"}],"lei":"\u003cstring>","insolvencies":[{"id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","current_status":"preliminary","court":"\u003cstring>","case_number":"\u003cstring>","proceeding_kind":"regular_insolvency","administration_kind":"external_administration","opened_at":"2023-12-25","closed_at":"2023-12-25"}]},"owners":{"company_id":"\u003cstring>","owners":[{"id":"\u003cstring>","type":"natural_person","relation_type":"shareholder","role_detail":{"code":"DIRECTOR","label_de":"\u003cstring>","label_de_short":"\u003cstring>","label_en":"\u003cstring>","label_en_short":"\u003cstring>"},"name":"\u003cstring>","natural_person":{"full_name":"\u003cstring>","first_name":"\u003cstring>","last_name":"\u003cstring>","date_of_birth":"\u003cstring>","city":"\u003cstring>","country":"\u003cstring>"},"legal_person":{"name":"\u003cstring>","city":"\u003cstring>","country":"\u003cstring>"},"nominal_share":123,"percentage_share":123,"start":"2023-12-25"}],"sources":[{"document_url":"\u003cstring>"}],"best_available":true}},"expires_at":"2023-11-07T05:31:56Z","created_at":"2023-11-07T05:31:56Z","finished_at":"2023-11-07T05:31:56Z"}}},"exampleType":"generated"}},"exampleType":"generated"},"07d9e9a2-9ac4-4171-8eb2-da724f05bd7d":{"description":"Unauthorized - Authentication required","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"7bd98040-b26f-48f2-9506-f397e32fce35":{"description":"Not Found - No such job","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"1b30a181-9050-48a6-abbe-9f3e1e23cfcb":{"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":"Get Job - OpenRegister","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-04T16:50:57.667Z","originalFileLocation":"endpoint/job-get.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Get a job\u0026#x27;s status and, once it completed, its result in results. Polling is free. - document jobs return results.document with a download URL, presigned again on every read. - company jobs return results.company, the same as GET /v1/company/{company_id}. - owners jobs return results.owners, the same as GET /v1/company/{company_id}/owners. Results are returned for 12 hours after the job finished (expires_at); after that, results is null and the regular endpoints serve the data.\">\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=\"Get Job - OpenRegister\">\u003cmeta data-mint-head property=\"og:description\" content=\"Get a job\u0026#x27;s status and, once it completed, its result in results. Polling is free. - document jobs return results.document with a download URL, presigned again on every read. - company jobs return results.company, the same as GET /v1/company/{company_id}. - owners jobs return results.owners, the same as GET /v1/company/{company_id}/owners. Results are returned for 12 hours after the job finished (expires_at); after that, results is null and the regular endpoints serve the data.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"OpenRegister\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.openregister.de/endpoint/job-get\">\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=Jobs\u0026amp;title=Get+Job\u0026amp;description=Get+a+job%27s+status+and%2C+once+it+completed%2C+its+result+in+%60results%60.+Polling+is+free.%0A-+%60document%60+jobs+return+%60results.document%60+with+a+download+URL%2C+presigned+\u0026amp;theme=ff1ffa3927752d914b134951\u0026amp;signature=6ec48d686e92f1e4bc0d4e5b92a9ad932d18d69c09b268246be6ecf10c7b992d\">\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=\"Get Job - OpenRegister\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Get a job\u0026#x27;s status and, once it completed, its result in results. Polling is free. - document jobs return results.document with a download URL, presigned again on every read. - company jobs return results.company, the same as GET /v1/company/{company_id}. - owners jobs return results.owners, the same as GET /v1/company/{company_id}/owners. Results are returned for 12 hours after the job finished (expires_at); after that, results is null and the regular endpoints serve the data.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://openregister.mintlify.app/_mintlify/api/og/v2?division=Jobs\u0026amp;title=Get+Job\u0026amp;description=Get+a+job%27s+status+and%2C+once+it+completed%2C+its+result+in+%60results%60.+Polling+is+free.%0A-+%60document%60+jobs+return+%60results.document%60+with+a+download+URL%2C+presigned+\u0026amp;theme=ff1ffa3927752d914b134951\u0026amp;signature=6ec48d686e92f1e4bc0d4e5b92a9ad932d18d69c09b268246be6ecf10c7b992d\">\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/job-get\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/endpoint/job-get.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/job-get#webpage\",\"url\":\"https://docs.openregister.de/endpoint/job-get\",\"name\":\"Get Job\",\"description\":\"Get a job's status and, once it completed, its result in results. Polling is free. - document jobs return results.document with a download URL, presigned again on every read. - company jobs return results.company, the same as GET /v1/company/{company_id}. - owners jobs return results.owners, the same as GET /v1/company/{company_id}/owners. Results are returned for 12 hours after the job finished (expires_at); after that, results is null and the regular endpoints serve the data.\",\"dateModified\":\"2026-11-04T16:50:57.667Z\",\"isPartOf\":{\"@id\":\"https://docs.openregister.de#website\"},\"breadcrumb\":{\"@id\":\"https://docs.openregister.de/endpoint/job-get#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.openregister.de/endpoint/job-get#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Jobs\",\"item\":\"https://docs.openregister.de/endpoint/job-create\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Get Job\",\"item\":\"https://docs.openregister.de/endpoint/job-get\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.openregister.de/endpoint/job-get#apireference\",\"headline\":\"Get Job\",\"name\":\"Get Job\",\"description\":\"Get a job's status and, once it completed, its result in results. Polling is free. - document jobs return results.document with a download URL, presigned again on every read. - company jobs return results.company, the same as GET /v1/company/{company_id}. - owners jobs return results.owners, the same as GET /v1/company/{company_id}/owners. Results are returned for 12 hours after the job finished (expires_at); after that, results is null and the regular endpoints serve the data.\",\"url\":\"https://docs.openregister.de/endpoint/job-get\",\"mainEntityOfPage\":{\"@id\":\"https://docs.openregister.de/endpoint/job-get#webpage\"},\"dateModified\":\"2026-11-04T16:50:57.667Z\",\"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","description":"Start a realtime request without waiting for it. The request returns at once with a pending job.\nUse this instead of `realtime=true` when your client cannot keep a request open for the minutes the\nHandelsregister may take.\n\nJob types:\n- `company`: refreshes the company from the Handelsregister, like `GET /v1/company/{company_id}?realtime=true`.\n- `owners`: refreshes the company's owners, like `GET /v1/company/{company_id}/owners?realtime=true`.\n- `document`: fetches one document, like `GET /v1/document`. Requires `document_category`.\n\nFollow a job either way, or both:\n- Poll `GET /v1/jobs/{job_id}` until `status` is `completed` or `failed`. A completed job\n carries its result in `results`: the document for a `document` job, the company or its owners for a\n `company` or `owners` job.\n- Configure a webhook endpoint: when the job finishes, OpenRegister sends a `job.completed` or `job.failed`\n webhook to it. The job can be polled all the same.\n\nJobs are available on paid plans. A completed job costs what the same request with `realtime=true`\ncosts: 20 credits for `company` and `owners`, 10 for `document`. Failed jobs and polling are free.\n","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","description":null,"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":"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":"Get Job - OpenRegister","buildId":"dpl_345ReqzYaAjzS9QpeJemsKdb7KDj","deploymentId":"dpl_345ReqzYaAjzS9QpeJemsKdb7KDj","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-C8RPHPxo.js","utils-0BK-9q6z.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-DfjzsUJT.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-B4v9psJ4.js","snippetPresets-CpTQv-Ez.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-BNP-Fvr0.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BSgu6h1D.js","shallow-Biv1i9Gs.js","getApiPlaygroundDisplay-BoGOXhtF.js","CodeSnippet-DvQoT18_.js","CodeSnippets-Dnpa15xT.js","Page-Buji1S4J.js","getPastedJson-xAIyhUFE.js","icon-S6FBih11.js","MethodPill-SaYeUZyk.js","DuplicateIcon-Cs-p3v2Q.js","createIcon-DjCFEoHq.js","DynamicMarkdown-BcnBltEQ.js","SectionHeading-BUBl0eEF.js","axios-vUo_bRtp.js","Markdown-h4cOoD8d.js","clsx-B2v50t8t.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-DJnKvr0g.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-BHrrjR1K.js"]}