Data Schema / ChangeLog



This is v0.1-rc (release candidate) of the Beneficial Ownership Data Standard. It includes updates to the data model and additional codelist information.

Implementers should be aware that future changes are anticipated, before a version 1.0 release. However, from this v0.1 release onwards, any structural changes, or major definitional changes will only take place following consultation, with a clear changelog provided, and with the documentation of previous versions maintained in archive form.

The schema specifies a structure, fields and codelists but does not yet enforce validation constraints on most fields.

[0.1] - 2018-12-12


  • beneficialOwnershipOrControl property added to Interest object. Takes a boolean value. Can be used to to assert that an interest between a natural person and an entity makes that person a beneficial owner.
  • pepStatus property add to personStatement object. Allows a natural person to be recorded as a politically exposed person (with a related reason, jurisdiction, start date and end date).
  • annotations property added to all three types of statement. Annotations provide a way of including additional (structured) data or transforming existing data in a targeted way.
  • An unspecified property replaces the nullParty option for interested parties. An unspecifiedReason codelist provides options for describing why an interested party is not recorded.


  • The interestType codelist has been extended to include interests in trusts.
  • The structure of BODS-formatted data has been flattened, to remove extraneous nesting and facilitate serialization using JSON Lines.
  • ‘Beneficial ownership statements’ have been renamed ‘Ownership-or-control statements’ to reflect the scope of their use.


  • Arrays of statementGroup objects (each object with its own statement group id) are no longer used to package arrays of statements. This reflects a flattening of the structure of BODS formatted data.
  • The nullParty option for interested parties. See unspecified property in the Added section above.