Recommended pattern for production integrations. Creates a request for an enhanced company profile and returns an orderId immediately, with no server-side connection hold. Use GET /orders/ to retrieve the profile when ready. The resulting profile data is identical to that returned by a successful GET 200 on this resource.
Holding connections server-side costs infrastructure capacity at scale. POST + poll avoids that cost: the server acknowledges immediately, and the client polls at its own cadence. This is the preferred pattern for high-volume pipelines and resource-conscious integrations.
GET is also available for ad-hoc or low-volume use (one-off scripts, manual exploration): it returns data directly when available in time and automatically falls back to 202 with an orderId otherwise.
Profile content (where filed in structured form at the registry):
Registration Information (Lite Profile + expanded details where available)
Share capital structure
Company Officials (incl. Directors) – including function, date of birth and address.
Shareholders (Beneficial owners) – including share count, share percentage and ID information.
Ultimate Beneficial Owners – where filed in structured form.
Profile extension type to include in the order result. shareholdingSummary populates additionalInformation.shareholdingSummary, which is described in the response of GET /companies/{kyckrId}/enhanced. Read the result from GET /orders/{orderId}/download?format=json at additionalInformation.shareholdingSummary. shareholdingSummary alone uses a threshold of 25. shareholdingSummary:<n> uses <n>, which is 5, 10, 15, 20 or 25, for example extend=shareholdingSummary:10. Names are case-insensitive. Each request carries one threshold. The option is read from the query string. Other values are ignored.
An unsupported threshold, such as shareholdingSummary:30, returns HTTP 400 with the detail shareholdingSummary threshold must be one of 5, 10, 15, 20, 25. More than one shareholdingSummary entry returns HTTP 400 with the detail shareholdingSummary may only be requested once. A 400 does not place an order and does not incur a charge.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/schema/docs.json","name":"Kyckr Developer Portal","colors":{"primary":"#0A955D","light":"#0CF191","dark":"#022A37"},"logo":{"light":"https://mintcdn.com/kyckr-0823abd6/9HYzjBYpwF1KfywI/logo/kyckr-light.svg?fit=max\u0026auto=format\u0026n=9HYzjBYpwF1KfywI\u0026q=85\u0026s=20b2e45cb5a675284a993a6e1a528191","dark":"https://mintcdn.com/kyckr-0823abd6/9HYzjBYpwF1KfywI/logo/kyckr-dark.svg?fit=max\u0026auto=format\u0026n=9HYzjBYpwF1KfywI\u0026q=85\u0026s=b662f6c44f6491f637c636b5dd752083"},"background":{"color":{"dark":"#022A37"}},"fonts":{"family":"Inter","format":"woff2"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"kyckr-0823abd6","hasAudioNarration":false,"actualSubdomain":"kyckr-0823abd6","customDomains":["developer.kyckr.com"],"gitSource":{"type":"github","owner":"kyckr","repo":"kyckr-developer-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6af3c7d4f804892cd158cf8c","clientVersion":"0.0.4111","searchFilterCounts":[{"language":"default","tag":"API Reference","count":34},{"language":"default","tag":"Country Guides","count":29},{"language":"default","tag":"Documentation","count":28},{"language":"default","tag":"Europe","count":20},{"language":"default","tag":"Company V1 API","count":18},{"language":"default","tag":"Features","count":12},{"language":"default","tag":"Company V2 API","count":10},{"language":"default","tag":"Platform Details","count":8},{"language":"default","tag":"Asia-Pacific","count":7},{"language":"default","tag":"Companies","count":5}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/companies/request-enhanced-profile","slug":"/api-reference/companies/request-enhanced-profile","pageMetadata":{"title":"Request Enhanced Profile","description":"**Recommended pattern for production integrations.** Creates a request for an enhanced company profile and returns an orderId immediately, with no server-side connection hold. Use GET /orders/{orderId} to retrieve the profile when ready. The resulting profile data is identical to that returned by a successful GET 200 on this resource.\n\nHolding connections server-side costs infrastructure capacity at scale. POST + poll avoids that cost: the server acknowledges immediately, and the client polls at its own cadence. This is the preferred pattern for high-volume pipelines and resource-conscious integrations.\n\nGET is also available for ad-hoc or low-volume use (one-off scripts, manual exploration): it returns data directly when available in time and automatically falls back to 202 with an orderId otherwise.\n\nProfile content (where filed in structured form at the registry):\n- Registration Information (Lite Profile + expanded details where available)\n- Share capital structure\n- Company Officials (incl. Directors) – including function, date of birth and address.\n- Shareholders (Beneficial owners) – including share count, share percentage and ID information.\n- Ultimate Beneficial Owners – where filed in structured form.\n","deprecated":null,"version":null,"openapi":"/openapi/company_v2.yaml post /companies/{kyckrId}/enhanced","href":"/api-reference/companies/request-enhanced-profile","autogeneratedByOpenApi":true},"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 li: \"li\",\n p: \"p\",\n strong: \"strong\",\n ul: \"ul\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsxs(_components.p, {\n children: [_jsx(_components.strong, {\n children: \"Recommended pattern for production integrations.\"\n }), \" Creates a request for an enhanced company profile and returns an orderId immediately, with no server-side connection hold. Use GET /orders/\", \" to retrieve the profile when ready. The resulting profile data is identical to that returned by a successful GET 200 on this resource.\"]\n }), \"\\n\", _jsx(_components.p, {\n children: \"Holding connections server-side costs infrastructure capacity at scale. POST + poll avoids that cost: the server acknowledges immediately, and the client polls at its own cadence. This is the preferred pattern for high-volume pipelines and resource-conscious integrations.\"\n }), \"\\n\", _jsx(_components.p, {\n children: \"GET is also available for ad-hoc or low-volume use (one-off scripts, manual exploration): it returns data directly when available in time and automatically falls back to 202 with an orderId otherwise.\"\n }), \"\\n\", _jsx(_components.p, {\n children: \"Profile content (where filed in structured form at the registry):\"\n }), \"\\n\", _jsxs(_components.ul, {\n children: [\"\\n\", _jsx(_components.li, {\n children: \"Registration Information (Lite Profile + expanded details where available)\"\n }), \"\\n\", _jsx(_components.li, {\n children: \"Share capital structure\"\n }), \"\\n\", _jsx(_components.li, {\n children: \"Company Officials (incl. Directors) – including function, date of birth and address.\"\n }), \"\\n\", _jsx(_components.li, {\n children: \"Shareholders (Beneficial owners) – including share count, share percentage and ID information.\"\n }), \"\\n\", _jsx(_components.li, {\n children: \"Ultimate Beneficial Owners – where filed in structured form.\"\n }), \"\\n\"]\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}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Request Enhanced Profile","description":"**Recommended pattern for production integrations.** Creates a request for an enhanced company profile and returns an orderId immediately, with no server-side connection hold. Use GET /orders/{orderId} to retrieve the profile when ready. The resulting profile data is identical to that returned by a successful GET 200 on this resource.\n\nHolding connections server-side costs infrastructure capacity at scale. POST + poll avoids that cost: the server acknowledges immediately, and the client polls at its own cadence. This is the preferred pattern for high-volume pipelines and resource-conscious integrations.\n\nGET is also available for ad-hoc or low-volume use (one-off scripts, manual exploration): it returns data directly when available in time and automatically falls back to 202 with an orderId otherwise.\n\nProfile content (where filed in structured form at the registry):\n- Registration Information (Lite Profile + expanded details where available)\n- Share capital structure\n- Company Officials (incl. Directors) – including function, date of birth and address.\n- Shareholders (Beneficial owners) – including share count, share percentage and ID information.\n- Ultimate Beneficial Owners – where filed in structured form.\n","deprecated":null,"version":null,"openapi":"/openapi/company_v2.yaml post /companies/{kyckrId}/enhanced","href":"/api-reference/companies/request-enhanced-profile","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"summary":"Request Enhanced Profile","responses":{"202":"eef5aa28-8d64-4f63-b884-27ecfe76b279","400":"a58be26c-e597-4330-b6b0-a977f575a8af","401":"6bbff740-a037-4e55-8562-57673e61ec6e","403":"585f2cc2-bd8f-46a1-b4cb-b101321ae9f6","404":"38e31319-dfbd-4ebb-ac93-a82a6cdd081c","429":"3f640b33-b298-4877-bca7-87e1429f6369"},"operationId":"post-companies-kyckrId-enhanced","description":"**Recommended pattern for production integrations.** Creates a request for an enhanced company profile and returns an orderId immediately, with no server-side connection hold. Use GET /orders/{orderId} to retrieve the profile when ready. The resulting profile data is identical to that returned by a successful GET 200 on this resource.\n\nHolding connections server-side costs infrastructure capacity at scale. POST + poll avoids that cost: the server acknowledges immediately, and the client polls at its own cadence. This is the preferred pattern for high-volume pipelines and resource-conscious integrations.\n\nGET is also available for ad-hoc or low-volume use (one-off scripts, manual exploration): it returns data directly when available in time and automatically falls back to 202 with an orderId otherwise.\n\nProfile content (where filed in structured form at the registry):\n- Registration Information (Lite Profile + expanded details where available)\n- Share capital structure\n- Company Officials (incl. Directors) – including function, date of birth and address.\n- Shareholders (Beneficial owners) – including share count, share percentage and ID information.\n- Ultimate Beneficial Owners – where filed in structured form.\n","parameters":["851a8215-d85b-49d2-b958-a874e8e4f1aa"],"requestBody":"8f49eeb8-f0b5-4eed-a87d-8fa9d22000c3","tags":["Companies"],"method":"post","type":"path","servers":["52056110-dacd-42df-b277-b4df3b874155","6582fdfb-ba6b-4769-a3c2-70b187893c91"],"security":["21181e8a-db2f-43ce-8605-55452752624c"],"path":"/companies/{kyckrId}/enhanced","baseUrlOptions":["https://api.kyckr.com/v2","https://test-api.kyckr.com/v2"],"title":"Request Enhanced Profile","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"851a8215-d85b-49d2-b958-a874e8e4f1aa":{"schema":{"type":"string","example":"shareholdingSummary:10","description":"Profile extension type to include in the order result. `shareholdingSummary` populates `additionalInformation.shareholdingSummary`, which is described in the response of GET /companies/{kyckrId}/enhanced. Read the result from GET /orders/{orderId}/download?format=json at `additionalInformation.shareholdingSummary`. `shareholdingSummary` alone uses a threshold of 25. `shareholdingSummary:\u003cn>` uses `\u003cn>`, which is 5, 10, 15, 20 or 25, for example `extend=shareholdingSummary:10`. Names are case-insensitive. Each request carries one threshold. The option is read from the query string. Other values are ignored.\n\nAn unsupported threshold, such as `shareholdingSummary:30`, returns HTTP 400 with the detail `shareholdingSummary threshold must be one of 5, 10, 15, 20, 25`. More than one `shareholdingSummary` entry returns HTTP 400 with the detail `shareholdingSummary may only be requested once`. A 400 does not place an order and does not incur a charge.","uniqueKey":"","typeLabel":"string"},"in":"query","name":"extend","description":"Profile extension type to include in the order result. `shareholdingSummary` populates `additionalInformation.shareholdingSummary`, which is described in the response of GET /companies/{kyckrId}/enhanced. Read the result from GET /orders/{orderId}/download?format=json at `additionalInformation.shareholdingSummary`. `shareholdingSummary` alone uses a threshold of 25. `shareholdingSummary:\u003cn>` uses `\u003cn>`, which is 5, 10, 15, 20 or 25, for example `extend=shareholdingSummary:10`. Names are case-insensitive. Each request carries one threshold. The option is read from the query string. Other values are ignored.\n\nAn unsupported threshold, such as `shareholdingSummary:30`, returns HTTP 400 with the detail `shareholdingSummary threshold must be one of 5, 10, 15, 20, 25`. More than one `shareholdingSummary` entry returns HTTP 400 with the detail `shareholdingSummary may only be requested once`. A 400 does not place an order and does not incur a charge."},"58c1e207-a6d4-4602-a849-d17306890e7b":{"name":"kyckrId","in":"path","required":true,"schema":{"type":"string","isRequired":true,"description":"Kyckr company reference, a shared format, usable across our V2 APIs","uniqueKey":"","typeLabel":"string"},"description":"Kyckr company reference, a shared format, usable across our V2 APIs","example":"GB|MTE2NTUyOTA"}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"customerReference":{"type":"string","description":"Optional client reference","uniqueKey":"customerReference","typeLabel":"string"},"contactEmail":{"type":"string","format":"email","description":"An email address that can be contacted in case of issues with the order","uniqueKey":"contactEmail","typeLabel":"string\u003cemail>"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"customerReference":"\u003cstring>","contactEmail":"jsmith@example.com"}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"eef5aa28-8d64-4f63-b884-27ecfe76b279":{"description":"Accepted: enhanced profile order created, profile not yet ready","content":{"application/json":{"schema":{"type":"object","title":"BaseResponse","description":"","properties":{"orderId":{"type":"string","example":"12345","description":"The related orderId.","uniqueKey":"orderId","typeLabel":"string"},"correlationId":{"type":"string","description":"The related correlationId to this request, for support purposes. \r\n","uniqueKey":"correlationId","typeLabel":"string"},"customerReference":{"type":"string","description":"A customer provided reference, which appears in the order list.","uniqueKey":"customerReference","typeLabel":"string"},"timeStamp":{"type":"string","format":"date-time","description":"The UTC time at which the request occurred.","uniqueKey":"timeStamp","typeLabel":"string\u003cdate-time>"},"details":{"type":"string","description":"The response status details for the current request. ","uniqueKey":"details","typeLabel":"string"},"cost":{"type":"object","description":"Cost of an item","properties":{"type":{"type":"string","enum":["credit","lite"],"example":"credit","uniqueKey":"cost.type","typeLabel":"enum\u003cstring>"},"value":{"type":"number","example":3,"uniqueKey":"cost.value","typeLabel":"number"}},"uniqueKey":"cost","typeLabel":"object"},"links":{"type":"object","properties":{"self":{"type":"string","format":"uri-reference","example":"/orders/12345","uniqueKey":"links.self","typeLabel":"string\u003curi-reference>"}},"uniqueKey":"links","typeLabel":"object"},"data":{"type":"object","properties":{"status":{"type":"string","enum":["Pending","Success","Failed"],"uniqueKey":"data.status","typeLabel":"enum\u003cstring>"},"orderId":{"type":"integer","description":"Use with GET /orders/{orderId} to retrieve the profile when ready","uniqueKey":"data.orderId","typeLabel":"integer"},"cost":{"type":"object","description":"Cost of an item","properties":{"type":{"type":"string","enum":["credit","lite"],"example":"credit","uniqueKey":"data.cost.type","typeLabel":"enum\u003cstring>"},"value":{"type":"number","example":3,"uniqueKey":"data.cost.value","typeLabel":"number"}},"uniqueKey":"data.cost","typeLabel":"object"}},"uniqueKey":"data","typeLabel":"object"}},"uniqueKey":"","typeLabel":"BaseResponse · object"},"examples":{"Example":{"title":"Example","value":{"correlationId":"string","timeStamp":"2019-08-24T14:15:22Z","data":{"status":"Pending","orderId":12345,"cost":{"type":"credit","value":1}}}}},"exampleType":"examples"}},"exampleType":"examples"},"a58be26c-e597-4330-b6b0-a977f575a8af":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","title":"BaseResponse","description":"","properties":{"orderId":{"type":"string","example":"12345","description":"The related orderId.","uniqueKey":"orderId","typeLabel":"string"},"correlationId":{"type":"string","description":"The related correlationId to this request, for support purposes. \r\n","uniqueKey":"correlationId","typeLabel":"string"},"customerReference":{"type":"string","description":"A customer provided reference, which appears in the order list.","uniqueKey":"customerReference","typeLabel":"string"},"timeStamp":{"type":"string","format":"date-time","description":"The UTC time at which the request occurred.","uniqueKey":"timeStamp","typeLabel":"string\u003cdate-time>"},"details":{"type":"string","description":"The response status details for the current request. ","uniqueKey":"details","typeLabel":"string"},"cost":{"type":"object","description":"Cost of an item","properties":{"type":{"type":"string","enum":["credit","lite"],"example":"credit","uniqueKey":"cost.type","typeLabel":"enum\u003cstring>"},"value":{"type":"number","example":3,"uniqueKey":"cost.value","typeLabel":"number"}},"uniqueKey":"cost","typeLabel":"object"},"links":{"type":"object","properties":{"self":{"type":"string","format":"uri-reference","example":"/orders/12345","uniqueKey":"links.self","typeLabel":"string\u003curi-reference>"}},"uniqueKey":"links","typeLabel":"object"},"data":{"title":"Problem Details","type":"object","properties":{"type":{"type":"string","uniqueKey":"data.type","typeLabel":"string"},"title":{"type":"string","uniqueKey":"data.title","typeLabel":"string"},"detail":{"type":"string","uniqueKey":"data.detail","typeLabel":"string"},"errors":{"type":"array","items":{"type":"string","uniqueKey":"data.errors.items.[INDEX]","typeLabel":"string"},"uniqueKey":"data.errors","typeLabel":"string[]"}},"uniqueKey":"data","typeLabel":"Problem Details · object"}},"uniqueKey":"","typeLabel":"BaseResponse · object"},"examples":{"Unsupported shareholdingSummary threshold":{"title":"Unsupported shareholdingSummary threshold","value":{"correlationId":"00000000-0000-0000-0000-000000000000","timeStamp":"2026-11-02T10:22:51.2677537Z","details":"Error","data":{"type":"400 Bad Request","title":"Bad Request","detail":"shareholdingSummary threshold must be one of 5, 10, 15, 20, 25"}}},"Repeated shareholdingSummary option":{"title":"Repeated shareholdingSummary option","value":{"correlationId":"00000000-0000-0000-0000-000000000000","timeStamp":"2026-11-02T10:22:51.2677537Z","details":"Error","data":{"type":"400 Bad Request","title":"Bad Request","detail":"shareholdingSummary may only be requested once"}}}},"exampleType":"examples"}},"exampleType":"examples"},"6bbff740-a037-4e55-8562-57673e61ec6e":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","title":"BaseResponse","description":"","properties":{"orderId":{"type":"string","example":"12345","description":"The related orderId.","uniqueKey":"orderId","typeLabel":"string"},"correlationId":{"type":"string","description":"The related correlationId to this request, for support purposes. \r\n","uniqueKey":"correlationId","typeLabel":"string"},"customerReference":{"type":"string","description":"A customer provided reference, which appears in the order list.","uniqueKey":"customerReference","typeLabel":"string"},"timeStamp":{"type":"string","format":"date-time","description":"The UTC time at which the request occurred.","uniqueKey":"timeStamp","typeLabel":"string\u003cdate-time>"},"details":{"type":"string","description":"The response status details for the current request. ","uniqueKey":"details","typeLabel":"string"},"cost":{"type":"object","description":"Cost of an item","properties":{"type":{"type":"string","enum":["credit","lite"],"example":"credit","uniqueKey":"cost.type","typeLabel":"enum\u003cstring>"},"value":{"type":"number","example":3,"uniqueKey":"cost.value","typeLabel":"number"}},"uniqueKey":"cost","typeLabel":"object"},"links":{"type":"object","properties":{"self":{"type":"string","format":"uri-reference","example":"/orders/12345","uniqueKey":"links.self","typeLabel":"string\u003curi-reference>"}},"uniqueKey":"links","typeLabel":"object"},"data":{"title":"Problem Details","type":"object","properties":{"type":{"type":"string","uniqueKey":"data.type","typeLabel":"string"},"title":{"type":"string","uniqueKey":"data.title","typeLabel":"string"},"detail":{"type":"string","uniqueKey":"data.detail","typeLabel":"string"},"errors":{"type":"array","items":{"type":"string","uniqueKey":"data.errors.items.[INDEX]","typeLabel":"string"},"uniqueKey":"data.errors","typeLabel":"string[]"}},"uniqueKey":"data","typeLabel":"Problem Details · object"}},"uniqueKey":"","typeLabel":"BaseResponse · object"},"examples":{"Unauthorized":{"title":"Unauthorized","value":{"orderId":12345,"correlationId":"string","customerReference":"string","timeStamp":"2019-08-24T14:15:22Z","details":"string","cost":{"type":"credit","value":0},"links":{"self":"../dictionary"},"data":{"type":"https://httpstatuses.com/401","title":"Unauthorized","detail":"Please authorize before making requests","errors":[]}}}},"exampleType":"examples"}},"exampleType":"examples"},"585f2cc2-bd8f-46a1-b4cb-b101321ae9f6":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","title":"BaseResponse","description":"","properties":{"orderId":{"type":"string","example":"12345","description":"The related orderId.","uniqueKey":"orderId","typeLabel":"string"},"correlationId":{"type":"string","description":"The related correlationId to this request, for support purposes. \r\n","uniqueKey":"correlationId","typeLabel":"string"},"customerReference":{"type":"string","description":"A customer provided reference, which appears in the order list.","uniqueKey":"customerReference","typeLabel":"string"},"timeStamp":{"type":"string","format":"date-time","description":"The UTC time at which the request occurred.","uniqueKey":"timeStamp","typeLabel":"string\u003cdate-time>"},"details":{"type":"string","description":"The response status details for the current request. ","uniqueKey":"details","typeLabel":"string"},"cost":{"type":"object","description":"Cost of an item","properties":{"type":{"type":"string","enum":["credit","lite"],"example":"credit","uniqueKey":"cost.type","typeLabel":"enum\u003cstring>"},"value":{"type":"number","example":3,"uniqueKey":"cost.value","typeLabel":"number"}},"uniqueKey":"cost","typeLabel":"object"},"links":{"type":"object","properties":{"self":{"type":"string","format":"uri-reference","example":"/orders/12345","uniqueKey":"links.self","typeLabel":"string\u003curi-reference>"}},"uniqueKey":"links","typeLabel":"object"},"data":{"title":"Problem Details","type":"object","properties":{"type":{"type":"string","uniqueKey":"data.type","typeLabel":"string"},"title":{"type":"string","uniqueKey":"data.title","typeLabel":"string"},"detail":{"type":"string","uniqueKey":"data.detail","typeLabel":"string"},"errors":{"type":"array","items":{"type":"string","uniqueKey":"data.errors.items.[INDEX]","typeLabel":"string"},"uniqueKey":"data.errors","typeLabel":"string[]"}},"uniqueKey":"data","typeLabel":"Problem Details · object"}},"uniqueKey":"","typeLabel":"BaseResponse · object"},"examples":{"Forbidden":{"title":"Forbidden","value":{"orderId":12345,"correlationId":"string","customerReference":"string","timeStamp":"2019-08-24T14:15:22Z","details":"string","cost":{"type":"credit","value":0},"links":{"self":"../dictionary"},"data":{"type":"https://httpstatuses.com/403","title":"Forbidden","detail":"This feature is not available on this account","errors":[]}}}},"exampleType":"examples"}},"exampleType":"examples"},"38e31319-dfbd-4ebb-ac93-a82a6cdd081c":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","title":"BaseResponse","description":"","properties":{"orderId":{"type":"string","example":"12345","description":"The related orderId.","uniqueKey":"orderId","typeLabel":"string"},"correlationId":{"type":"string","description":"The related correlationId to this request, for support purposes. \r\n","uniqueKey":"correlationId","typeLabel":"string"},"customerReference":{"type":"string","description":"A customer provided reference, which appears in the order list.","uniqueKey":"customerReference","typeLabel":"string"},"timeStamp":{"type":"string","format":"date-time","description":"The UTC time at which the request occurred.","uniqueKey":"timeStamp","typeLabel":"string\u003cdate-time>"},"details":{"type":"string","description":"The response status details for the current request. ","uniqueKey":"details","typeLabel":"string"},"cost":{"type":"object","description":"Cost of an item","properties":{"type":{"type":"string","enum":["credit","lite"],"example":"credit","uniqueKey":"cost.type","typeLabel":"enum\u003cstring>"},"value":{"type":"number","example":3,"uniqueKey":"cost.value","typeLabel":"number"}},"uniqueKey":"cost","typeLabel":"object"},"links":{"type":"object","properties":{"self":{"type":"string","format":"uri-reference","example":"/orders/12345","uniqueKey":"links.self","typeLabel":"string\u003curi-reference>"}},"uniqueKey":"links","typeLabel":"object"},"data":{"title":"Problem Details","type":"object","properties":{"type":{"type":"string","uniqueKey":"data.type","typeLabel":"string"},"title":{"type":"string","uniqueKey":"data.title","typeLabel":"string"},"detail":{"type":"string","uniqueKey":"data.detail","typeLabel":"string"},"errors":{"type":"array","items":{"type":"string","uniqueKey":"data.errors.items.[INDEX]","typeLabel":"string"},"uniqueKey":"data.errors","typeLabel":"string[]"}},"uniqueKey":"data","typeLabel":"Problem Details · object"}},"uniqueKey":"","typeLabel":"BaseResponse · object"},"examples":{"Not Found":{"title":"Not Found","value":{"orderId":12345,"correlationId":"string","customerReference":"string","timeStamp":"2019-08-24T14:15:22Z","details":"string","cost":{"type":"credit","value":0},"links":{"self":"../dictionary"},"data":{"type":"https://httpstatuses.com/404","title":"Not Found","detail":"This resource could not be found","errors":[]}}}},"exampleType":"examples"}},"exampleType":"examples"},"3f640b33-b298-4877-bca7-87e1429f6369":{"description":"Too many requests","content":{"application/json":{"schema":{"type":"object","title":"BaseResponse","description":"","properties":{"orderId":{"type":"string","example":"12345","description":"The related orderId.","uniqueKey":"orderId","typeLabel":"string"},"correlationId":{"type":"string","description":"The related correlationId to this request, for support purposes. \r\n","uniqueKey":"correlationId","typeLabel":"string"},"customerReference":{"type":"string","description":"A customer provided reference, which appears in the order list.","uniqueKey":"customerReference","typeLabel":"string"},"timeStamp":{"type":"string","format":"date-time","description":"The UTC time at which the request occurred.","uniqueKey":"timeStamp","typeLabel":"string\u003cdate-time>"},"details":{"type":"string","description":"The response status details for the current request. ","uniqueKey":"details","typeLabel":"string"},"cost":{"type":"object","description":"Cost of an item","properties":{"type":{"type":"string","enum":["credit","lite"],"example":"credit","uniqueKey":"cost.type","typeLabel":"enum\u003cstring>"},"value":{"type":"number","example":3,"uniqueKey":"cost.value","typeLabel":"number"}},"uniqueKey":"cost","typeLabel":"object"},"links":{"type":"object","properties":{"self":{"type":"string","format":"uri-reference","example":"/orders/12345","uniqueKey":"links.self","typeLabel":"string\u003curi-reference>"}},"uniqueKey":"links","typeLabel":"object"},"data":{"title":"Problem Details","type":"object","properties":{"type":{"type":"string","uniqueKey":"data.type","typeLabel":"string"},"title":{"type":"string","uniqueKey":"data.title","typeLabel":"string"},"detail":{"type":"string","uniqueKey":"data.detail","typeLabel":"string"},"errors":{"type":"array","items":{"type":"string","uniqueKey":"data.errors.items.[INDEX]","typeLabel":"string"},"uniqueKey":"data.errors","typeLabel":"string[]"}},"uniqueKey":"data","typeLabel":"Problem Details · object"}},"uniqueKey":"","typeLabel":"BaseResponse · object"},"examples":{"Rate limit exceeded":{"title":"Rate limit exceeded","value":{"orderId":12345,"correlationId":"string","customerReference":"string","timeStamp":"2019-08-24T14:15:22Z","details":"string","cost":{"type":"credit","value":0},"links":{"self":"../dictionary"},"data":{"type":"https://httpstatuses.com/429","title":"Too Many Requests","detail":"This service rate limit has been reached","errors":[]}}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"21181e8a-db2f-43ce-8605-55452752624c":{"AuthHeader":{"type":"http","scheme":"bearer","scopes":[],"schemeName":"AuthHeader"}}},"servers":{"52056110-dacd-42df-b277-b4df3b874155":{"url":"https://api.kyckr.com/v2","description":"Production"},"6582fdfb-ba6b-4769-a3c2-70b187893c91":{"url":"https://test-api.kyckr.com/v2","description":"Testing"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","scopes":[],"schemeName":"AuthHeader"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"AuthHeader","name":"Authorization"}],"title":"AuthHeader"}]},"originalFileLocation":"openapi/company_v2.yaml"},"subdomain":"kyckr-0823abd6","siteName":"Kyckr Developer Portal","title":"Request Enhanced Profile - Kyckr Developer Portal","navMaps":{"firstHrefInVersion":{"Company V2":{"href":"/api-reference/companies/request-enhanced-profile","matchLevel":0},"Company V1":{"href":"/Introduction","matchLevel":4}},"firstHrefInLanguage":{}},"lastModified":"2026-11-10T16:50:59.048Z","originalFileLocation":"api-reference/companies/request-enhanced-profile.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=\"Recommended pattern for production integrations. Creates a request for an enhanced company profile and returns an orderId immediately, with no server-side connection hold. Use GET /orders/{orderId} to retrieve the profile when ready. The resulting profile data is identical to that returned by a successful GET 200 on this resource. Holding connections server-side costs infrastructure capacity at scale. POST + poll avoids that cost: the server acknowledges immediately, and the client polls at its own cadence. This is the preferred pattern for high-volume pipelines and resource-conscious integrations. GET is also available for ad-hoc or low-volume use (one-off scripts, manual exploration): it returns data directly when available in time and automatically falls back to 202 with an orderId otherwise. Profile content (where filed in structured form at the registry): - Registration Information (Lite Profile + expanded details where available) - Share capital structure - Company Officials (incl. Directors) – including function, date of birth and address. - Shareholders (Beneficial owners) – including share count, share percentage and ID information. - Ultimate Beneficial Owners – where filed in structured form.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Kyckr Developer Portal\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/kyckr-0823abd6/_generated/favicon/apple-touch-icon.png?v=3\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/kyckr-0823abd6/_generated/favicon/favicon-32x32.png?v=3\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/kyckr-0823abd6/_generated/favicon/favicon-16x16.png?v=3\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/kyckr-0823abd6/_generated/favicon/favicon.ico?v=3\">\u003cmeta data-mint-head property=\"og:title\" content=\"Request Enhanced Profile - Kyckr Developer Portal\">\u003cmeta data-mint-head property=\"og:description\" content=\"Recommended pattern for production integrations. Creates a request for an enhanced company profile and returns an orderId immediately, with no server-side connection hold. Use GET /orders/{orderId} to retrieve the profile when ready. The resulting profile data is identical to that returned by a successful GET 200 on this resource. Holding connections server-side costs infrastructure capacity at scale. POST + poll avoids that cost: the server acknowledges immediately, and the client polls at its own cadence. This is the preferred pattern for high-volume pipelines and resource-conscious integrations. GET is also available for ad-hoc or low-volume use (one-off scripts, manual exploration): it returns data directly when available in time and automatically falls back to 202 with an orderId otherwise. Profile content (where filed in structured form at the registry): - Registration Information (Lite Profile + expanded details where available) - Share capital structure - Company Officials (incl. Directors) – including function, date of birth and address. - Shareholders (Beneficial owners) – including share count, share percentage and ID information. - Ultimate Beneficial Owners – where filed in structured form.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Kyckr Developer Portal\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://developer.kyckr.com/api-reference/companies/request-enhanced-profile\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://kyckr-0823abd6.mintlify.site/_mintlify/api/og/v2?division=Companies\u0026amp;title=Request+Enhanced+Profile\u0026amp;description=**Recommended+pattern+for+production+integrations.**+Creates+a+request+for+an+enhanced+company+profile+and+returns+an+orderId+immediately%2C+with+no+server-side+c\u0026amp;theme=49b3d6ccc6497baec79937a6\u0026amp;signature=24c3f9f4af6e4a7f519f178c06082d83adad8c2f400f83e84b1a64ea12d5154d\">\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=\"Request Enhanced Profile - Kyckr Developer Portal\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Recommended pattern for production integrations. Creates a request for an enhanced company profile and returns an orderId immediately, with no server-side connection hold. Use GET /orders/{orderId} to retrieve the profile when ready. The resulting profile data is identical to that returned by a successful GET 200 on this resource. Holding connections server-side costs infrastructure capacity at scale. POST + poll avoids that cost: the server acknowledges immediately, and the client polls at its own cadence. This is the preferred pattern for high-volume pipelines and resource-conscious integrations. GET is also available for ad-hoc or low-volume use (one-off scripts, manual exploration): it returns data directly when available in time and automatically falls back to 202 with an orderId otherwise. Profile content (where filed in structured form at the registry): - Registration Information (Lite Profile + expanded details where available) - Share capital structure - Company Officials (incl. Directors) – including function, date of birth and address. - Shareholders (Beneficial owners) – including share count, share percentage and ID information. - Ultimate Beneficial Owners – where filed in structured form.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://kyckr-0823abd6.mintlify.site/_mintlify/api/og/v2?division=Companies\u0026amp;title=Request+Enhanced+Profile\u0026amp;description=**Recommended+pattern+for+production+integrations.**+Creates+a+request+for+an+enhanced+company+profile+and+returns+an+orderId+immediately%2C+with+no+server-side+c\u0026amp;theme=49b3d6ccc6497baec79937a6\u0026amp;signature=24c3f9f4af6e4a7f519f178c06082d83adad8c2f400f83e84b1a64ea12d5154d\">\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=\"https://mintlify.s3.us-west-1.amazonaws.com/kyckr-0823abd6/_generated/favicon/browserconfig.xml?v=3\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Kyckr Developer Portal\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0A955D\">\u003clink data-mint-head rel=\"canonical\" href=\"https://developer.kyckr.com/api-reference/companies/request-enhanced-profile\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/companies/request-enhanced-profile.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://developer.kyckr.com/#organization\",\"name\":\"Kyckr Developer Portal\",\"url\":\"https://developer.kyckr.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/kyckr-0823abd6/9HYzjBYpwF1KfywI/logo/kyckr-light.svg?fit=max\u0026auto=format\u0026n=9HYzjBYpwF1KfywI\u0026q=85\u0026s=20b2e45cb5a675284a993a6e1a528191\"}},{\"@type\":\"WebSite\",\"@id\":\"https://developer.kyckr.com#website\",\"name\":\"Kyckr Developer Portal\",\"url\":\"https://developer.kyckr.com\",\"publisher\":{\"@id\":\"https://developer.kyckr.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://developer.kyckr.com/api-reference/companies/request-enhanced-profile#webpage\",\"url\":\"https://developer.kyckr.com/api-reference/companies/request-enhanced-profile\",\"name\":\"Request Enhanced Profile\",\"description\":\"Recommended pattern for production integrations. Creates a request for an enhanced company profile and returns an orderId immediately, with no server-side connection hold. Use GET /orders/{orderId} to retrieve the profile when ready. The resulting profile data is identical to that returned by a successful GET 200 on this resource. Holding connections server-side costs infrastructure capacity at scale. POST + poll avoids that cost: the server acknowledges immediately, and the client polls at its own cadence. This is the preferred pattern for high-volume pipelines and resource-conscious integrations. GET is also available for ad-hoc or low-volume use (one-off scripts, manual exploration): it returns data directly when available in time and automatically falls back to 202 with an orderId otherwise. Profile content (where filed in structured form at the registry): - Registration Information (Lite Profile + expanded details where available) - Share capital structure - Company Officials (incl. Directors) – including function, date of birth and address. - Shareholders (Beneficial owners) – including share count, share percentage and ID information. - Ultimate Beneficial Owners – where filed in structured form.\",\"dateModified\":\"2026-11-10T16:50:59.048Z\",\"isPartOf\":{\"@id\":\"https://developer.kyckr.com#website\"},\"breadcrumb\":{\"@id\":\"https://developer.kyckr.com/api-reference/companies/request-enhanced-profile#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://developer.kyckr.com/api-reference/companies/request-enhanced-profile#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Company V2 API\",\"item\":\"https://developer.kyckr.com/company-v2/api-reference/changelog\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Companies\",\"item\":\"https://developer.kyckr.com/api-reference/companies/search-for-companies\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Request Enhanced Profile\",\"item\":\"https://developer.kyckr.com/api-reference/companies/request-enhanced-profile\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://developer.kyckr.com/api-reference/companies/request-enhanced-profile#apireference\",\"headline\":\"Request Enhanced Profile\",\"name\":\"Request Enhanced Profile\",\"description\":\"Recommended pattern for production integrations. Creates a request for an enhanced company profile and returns an orderId immediately, with no server-side connection hold. Use GET /orders/{orderId} to retrieve the profile when ready. The resulting profile data is identical to that returned by a successful GET 200 on this resource. Holding connections server-side costs infrastructure capacity at scale. POST + poll avoids that cost: the server acknowledges immediately, and the client polls at its own cadence. This is the preferred pattern for high-volume pipelines and resource-conscious integrations. GET is also available for ad-hoc or low-volume use (one-off scripts, manual exploration): it returns data directly when available in time and automatically falls back to 202 with an orderId otherwise. Profile content (where filed in structured form at the registry): - Registration Information (Lite Profile + expanded details where available) - Share capital structure - Company Officials (incl. Directors) – including function, date of birth and address. - Shareholders (Beneficial owners) – including share count, share percentage and ID information. - Ultimate Beneficial Owners – where filed in structured form.\",\"url\":\"https://developer.kyckr.com/api-reference/companies/request-enhanced-profile\",\"mainEntityOfPage\":{\"@id\":\"https://developer.kyckr.com/api-reference/companies/request-enhanced-profile#webpage\"},\"dateModified\":\"2026-11-10T16:50:59.048Z\",\"publisher\":{\"@id\":\"https://developer.kyckr.com/#organization\"},\"isPartOf\":{\"@id\":\"https://developer.kyckr.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Kyckr Developer Portal\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Kyckr Developer Portal\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/companies/request-enhanced-profile.md","siteName":"Kyckr Developer Portal","nav":{"global":null,"versions":[{"version":"Company V2","default":true,"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/Introduction"}]},{"tab":"API Reference","groups":[{"group":"About","pages":[{"title":"Overview","href":"/company-v2/api-reference/overview"}]},{"group":"Company V2 API","pages":[{"title":"Changelog","href":"/company-v2/api-reference/changelog"},{"group":"Companies","pages":[{"title":"Search for companies","deprecated":null,"version":null,"openapi":"/openapi/company_v2.yaml get /companies","href":"/api-reference/companies/search-for-companies"},{"title":"Lite Profile","deprecated":null,"version":null,"openapi":"/openapi/company_v2.yaml get /companies/{kyckrId}/lite","href":"/api-reference/companies/lite-profile"},{"title":"Enhanced Profile","description":"Retrieve an enhanced company profile. The server holds the connection open while the registry fulfils the request. If the profile is ready in time, it is returned with HTTP 200. If not, HTTP 202 is returned with an orderId in the response body; poll GET /orders/{orderId} to retrieve the profile when complete. For production and high-volume integrations, POST is preferred: it returns an orderId immediately with no server-side connection hold, avoiding infrastructure cost at scale.\r\n\r\nThe profile includes (where filed in structured form at the registry):\r\n\r\n- Registration Information (Lite Profile + expanded details where available)\r\n- Share capital structure\r\n- Company Officials (incl. Directors) – including function, date of birth and address.\r\n- Shareholders (Beneficial owners) – including share count, share percentage and ID information.\r\n- Ultimate Beneficial Owners – where filed in structured form.","deprecated":null,"version":null,"openapi":"/openapi/company_v2.yaml get /companies/{kyckrId}/enhanced","href":"/api-reference/companies/enhanced-profile"},{"title":"Request Enhanced Profile","deprecated":null,"version":null,"openapi":"/openapi/company_v2.yaml post /companies/{kyckrId}/enhanced","href":"/api-reference/companies/request-enhanced-profile"},{"title":"Documents","description":"Retrieve a list of available documents for a company. After finding a document of interest, use the Create Order API to order a copy of the document.","deprecated":null,"version":null,"openapi":"/openapi/company_v2.yaml get /companies/{kyckrId}/documents","href":"/api-reference/companies/documents"}]},{"group":"Orders","pages":[{"title":"Get List of Orders","deprecated":null,"version":null,"openapi":"/openapi/company_v2.yaml get /orders","href":"/api-reference/orders/get-list-of-orders"},{"title":"Create Order","deprecated":null,"version":null,"openapi":"/openapi/company_v2.yaml post /orders","href":"/api-reference/orders/create-order"},{"title":"Get Single Order","deprecated":null,"version":null,"openapi":"/openapi/company_v2.yaml get /orders/{orderId}","href":"/api-reference/orders/get-single-order"},{"title":"Download Order Payload","deprecated":null,"version":null,"openapi":"/openapi/company_v2.yaml get /orders/{orderId}/download","href":"/api-reference/orders/download-order-payload"}]}]},{"group":"UBO Register API","pages":[{"title":"Changelog","href":"/bo-v2/changelog"},{"group":"Data Model","pages":[{"title":"UBO Register Profile","href":"/bo-v2/schemas/bo-profile"}]},{"group":"Operations","pages":[{"title":"Order a UBO Register Profile","deprecated":null,"version":null,"openapi":"/openapi/bo_v2.yaml post /companies/{kyckrId}/uboregister","href":"/api-reference/operations/order-a-ubo-register-profile"}]}]}]},{"tab":"Developer News","pages":[{"title":"Developer News","href":"/company-v2/developer-news"}]},{"tab":"Country Guides","pages":[{"title":"Country Guides","href":"/country-guides/austria"}]},{"tab":"UBO Verify V2 (Preview)","hidden":true,"pages":[{"title":"UBO Verify V2 (Preview)","href":"/ubo-v2/guides/getting-started"}]}]},{"version":"Company V1","pages":[{"title":"Company V1","href":"/Introduction"}]}]},"basePath":"","title":"Request Enhanced Profile - Kyckr Developer Portal","buildId":"dpl_DqYu5MPb49gWBBbUGgpHQUmCHY3P","deploymentId":"dpl_DqYu5MPb49gWBBbUGgpHQUmCHY3P","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CybtLBIt.js","utils-BMLj2fvV.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-B6In562Y.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-Dr8Mfhp9.js","snippetPresets-2rmQvMVl.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-WMqJYdZj.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-CJ-MlPHu.js","shallow-dY3TMRCk.js","getApiPlaygroundDisplay-v-1B2bKm.js","CodeSnippet-BDhiTB7U.js","CodeSnippets-D9hnzQcS.js","Page-C4GwDT3_.js","getPastedJson-Th2V45jI.js","icon-BQXch1W9.js","MethodPill-BCqUneP3.js","DuplicateIcon-Q_-bhurZ.js","createIcon-DUjLHRqp.js","DynamicMarkdown-B-f2cqXQ.js","SectionHeading-Da5NsV4v.js","axios-vUo_bRtp.js","Markdown-D13FWkIM.js","clsx-D3Isdib3.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-C-XZBk9h.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink--qIqmmVG.js"]}