Skip to main content
Changes to the Companies V2 API contract, newest first. Use the tag filters to narrow the list.
​
Enhanced ProfileOrders
Async order pattern for Enhanced ProfilePOST /companies/{kyckrId}/enhanced is the recommended production pattern: it returns an orderId immediately with no connection hold; poll GET /orders/{orderId} for the profile. GET gains a 202 fallback carrying the orderId in the response body, enabled per jurisdiction: Luxembourg today.
See the release note for integration guidance.
​
OrdersDocumentation
Download endpoint now documentedGET /v2/orders/{orderId}/download is now documented in the API reference. The endpoint takes a format=json or format=pdf query parameter and returns the order result in the requested format.
No change to the API: this endpoint is already available and its behaviour is unchanged; this entry only documents it.
​
Enhanced Profile
Profile extensions and address geocodingEnhanced Profile now supports opt-in, per-account extensions that enrich the response with extra data. The first extension, geocoding, returns parsed and geocoded address information.
  • Request extensions with the new extend query parameter (a comma-separated list) on GET Enhanced Profile.
  • geocoding adds parsed and geocoded address data via the additionalInformation response object.
  • Each Address now carries a stable identifier that links it to its geocoded entry in additionalInformation.addressInformation.
  • New schemas: AdditionalInformation, AddressAdditionalInformation, InformationSource.
  • The mechanism is extensible: further extension types (e.g. firmographics, activity codes) will follow.
  • Unrecognised or unauthorised extend values are ignored silently.
Opt-in and entitled per account; each extension type carries an additional cost.
​
Enhanced Profile
Typed corporate identifiersCorporate representatives and shareholders can now carry multiple typed identifiers: ACN, ABN, ARBN, ARSN, ARFN, and foreign registration numbers, via a new otherIdentifiers array on CorporationDetails.
Backwards compatible: reuses the existing Identifier schema. First surfaced for Australian (ASIC) companies.
​
Enhanced Profile
Shareholding percentage rangesShareholdings can now express an ownership range when a registry does not report an exact percentage.
  • Shareholding.percentage is now nullable. When a range applies, percentage is null and percentageIsRange, percentageRange, percentageLowerLimit, and percentageUpperLimit carry the range.
Supports registries such as Estonia (EE) that may report ownership as a range (e.g. “0–100%”).
​
Enhanced Profile
Company relationships and registration typeEnhanced Profile can now carry company-relationship data and source-registry registration classification.
  • New companyRelationships array for relational extract data: subsidiaries, and company evolution (merged, demerged, acquired). Parent / ultimate parent / immediate parent remain in roles and corporate representatives; branches and establishments use a separate establishments model.
  • New registrationType and registrationTypeDetails capture the foreign registered body and its details at the source registry, where available.
companyRelationships is in place now for forthcoming relational extract data: do not expect it populated for every entity yet.
​
Enhanced Profile
POST Enhanced ProfileYou can now request an Enhanced Profile with POST /companies/{kyckrId}/enhanced: the same resource as GET, but it creates an order without holding the connection open.
See the 2026-08 entry for the full async semantics: POST + poll for Enhanced Profile, and a 202 fallback on GET with orderId in the response body.
​
Search
Typed identifiers in Search resultsSearch results now include typed identifiers via an otherIdentifiers array with type codes.
Available on the single V2 search endpoint. Enables jurisdiction-specific identifier types.
​
Profiles
Field consistency across profilesProfile responses are now more consistent across the V2 API, with shared name components and additional LiteProfile and BasicProfile fields.
  • New reusable AlternativeNames and PreviousNames schema components.
  • previousNames now uses a standardised structure with proper schema references.
  • LiteProfile gains registrationDate and lastAnnualAccountDate.
  • BasicProfile gains registeredAgentName and registeredAgentAddress.
Aligns LiteProfile date fields and registered-agent information with V1 and EnhancedProfile.
​
Orders
Order response documentation fixCorrected the Get Order API response documentation, and documented additional response properties.
Planned: previous names on SearchResults; Enhanced Profile additions: UBO kind, last annual account date, and registry-sourced voting-rights descriptions.
​
Enhanced Profile
Capital and shareholding simplificationCapital and shareholding structures are simplified, and corporate identifiers move to the typed otherIdentifiers array.
  • Simplified capital and shareholding structures.
  • tradingName is deprecated: use alias instead.
  • New otherIdentifiers with jurisdiction-specific type codes.
otherIdentifiers will gain further type codes per jurisdiction over time.
​
Enhanced Profile
Beneficially-held shareholdingsEnhanced Profile can now flag beneficially-held shareholdings and classify ambiguous entities.
  • New capital[].shareholdings[].beneficiallyHeld field on Enhanced Profile.
  • New “Other” category in the corporations and individuals arrays for entities the registry cannot definitively classify.
Introduced ahead of an Australian registry update.
​
Documentation
Documentation correctionsClarified the ultimateBeneficialOwners field descriptions on Enhanced Profile.
​
Documentation
Documentation correctionsCorrected the Enhanced Profile ultimateBeneficialOwners documentation.