v1

latestOpenAPI 3.0.3Kyckr API License2026-07-2293773.2 KB
Companies

Request Enhanced Profile

🚧 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.
post/companies/{kyckrId}/enhanced

Request body

customerReferencestring

Optional client reference

contactEmailstring email

An email address that can be contacted in case of issues with the order