---
title: "Request Enhanced Profile"
method: POST
path: "/companies/{kyckrId}/enhanced"
tags: ["Companies"]
---

# Request Enhanced Profile

`POST /companies/{kyckrId}/enhanced`

🚧 COMING SOON

**Recommended pattern for production integrations.** Creates a request for an enhanced company profile and returns an orderId immediately — 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.

For ad-hoc or low-volume use (one-off scripts, manual exploration), GET is available as a convenience: it returns data directly when available within ~40s 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.

## Request body

- object
  - `customerReference` string — Optional client reference
  - `contactEmail` string, email — An email address that can be contacted in case of issues with the order

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `429` — Too many requests

---

[API](https://skmtc.net/kyckr/apis/kyckr-companies-v2-api.md) · [All operations](https://skmtc.net/kyckr/apis/kyckr-companies-v2-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kyckr/kyckr-companies-v2-api/revisions/ed17e149d3c8/schema)