Skip to main content
Changes to the Companies V2 API contract, newest first. Use the tag filters to narrow the list.
Profiles
Activity classification schemes NACErev2 and NACErev2.1activities[].classificationScheme accepts two new values, NACErev2 and NACErev2.1, which identify the revision of NACE that the activity code belongs to. Existing values are unchanged.
Enhanced Profile
Shareholding summary extensionextend=shareholdingSummary returns each owner’s combined shareholding across every share class and a beneficial ownership resolution for one threshold.
  • shareholdingSummary uses a threshold of 25. shareholdingSummary:<n> uses <n>, one of 5, 10, 15, 20 or 25.
  • An unsupported threshold or a repeated shareholdingSummary option returns HTTP 400 with the allowed values.
  • POST /companies/{kyckrId}/enhanced accepts extend in the query string for shareholdingSummary. The result is in GET /orders/{orderId}/download?format=json.
  • The result is in additionalInformation.shareholdingSummary as owners[] and beneficialOwnershipResolution.
  • New schemas: ShareholdingSummaryAdditionalInformation, ShareholdingSummaryOwner, ShareholdingSummaryResolution, ShareholdingSummaryClassContribution, ShareRange.
See the release note for integration guidance.
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.