Data Standard / Schema reference

Schema reference¶

Attention

This is v0.4 of the Beneficial Ownership Data Standard. It includes updates to the data model, codelists, and technical guidance.

Future changes are anticipated before a version 1.0 release. See the Changelog and About pages for more information.

This is an A - Z guide to the objects of the Data Standard’s schema and its codelists . Details of each object’s properties are provided in a table. For a structured view of how objects fit together in the JSON schema, use the Schema browser.

The top-level objects are Statements. Each statement contains record details for one of three beneficial ownership elements:

Entity
Person
Relationship

BODS data MAY be published as a valid JSON document. See Serialisation for other options.

Address¶

Semi-structured address details, suitable for processing using address-parsing algorithms. Where postal codes and country information are isolated fields in source systems, this information SHOULD be published in the dedicated fields and SHOULD NOT be published in the `address` field.

Title	Description	Type
`type`		string
Type	The function of the address, using the addressType codelist. See Address Type
`address`		string
Address	The address, with each line or component separated by a line-break or comma.
`postCode`		string
Postcode	The postal code for this address.
`country`		object
Country	The country for this address. See Country

Note

Various address formats are used across data management systems, and data is often inconsistent. That is why the BODS schema uses a simple address format for data exchange. Systems importing BODS data will need to parse BODS addresses before carrying out any structured comparison.

Designers of new data collection systems should choose an appropriate structured format, with reference to established standards, that can accommodate addresses from across the world. See issue 18 for more details.

Annotation¶

The annotations property of statements is an array of Annotation objects.

Annotations can be used to:

hold information that does not have an appropriate field in the schema
provide additional context to information in the schema (e.g. if data has been transformed)

Annotations can apply to a whole statement, part of a statement or a specific field. annotation.statementPointerTarget indicates where the annotation applies.

Title	Description	Type	Format
`statementPointerTarget`		string
Statement Fragment Pointer	An RFC6901 JSON Pointer (https://tools.ietf.org/html/rfc6901) describing the target fragment of the statement that this Annotation applies to, starting from the root of the Statement. An empty string (“”) indicates that the Annotation applies to the whole Statement.
`creationDate`		string
Creation Date	The date on which this Annotation was created, in full-date (YYYY-MM-DD) or date-time (e.g. YYYY-MM-DDTHH:MM:SSZ) format. See the IETF RFC3339 standard, section 5.6.
`createdBy`		object
Created By	The person, organisation or agent that created this Annotation.
`createdBy/name`		string
Name	The name of the person, organisation or agent that created this Annotation.
`createdBy/uri`		string	uri
URI	An optional URI to identify the person, organisation or agent that created this Annotation.
`motivation`		string
Motivation	The reason for this Annotation, using the annotationMotivation codelist. See Annotation Motivation
`description`		string
Description	A free text description providing extra information about part of this Statement.
`transformedContent`		string
Transformed Content	A representation of the Annotation target after the transformation in the `description` field has been applied. This field MUST only be used when the `motivation` is ‘transformation’.
`url`		string	uri
URL	A linked resource that annotates, provides context for or enhances this Statement. The content of the resource, or the relationship to the statement, MAY be described in the `description` field. This field is REQUIRED if the value of `motivation` is ‘linking’.

Country¶

A country MUST have a name. A country SHOULD have a 2-letter country code (ISO 3166-1)

Title	Description	Type	Required
`name`		string	Required
Name	The name of the country
`code`		string
Country Code	The 2-letter country code (ISO 3166-1) for this country.

Identifier¶

The Identifier object connects a statement to the natural person, entity or item that it refers to. See Real world identifiers for guidance on using this object.

An identifier that has been assigned to a person or entity. `scheme` or `schemeName` (or both) MUST be included in an Identifier object.

Title	Description	Type	Format
`id`		string
ID	The identifier for a person or entity, as issued by the scheme.
`scheme`		string
Scheme Code	For entities, a code from org-id.guide (https://www.org-id.guide) for an identifier-issuing authority (e.g. ‘GB-COH’). For natural persons, a value with the pattern {JURISDICTION}-{TYPE} where JURISDICTION is an ISO 3166-1 3-digit country code and TYPE is one of PASSPORT, TAXID or IDCARD.
`schemeName`		string
Scheme Name	The name of the identifier-issuing authority.
`uri`		string	uri
URI	A canonical URI (https://en.wikipedia.org/wiki/Uniform_Resource_Identifier) for the identifier and associated details of the person or entity, if one exists.

Interest¶

A description of an interest held by an interestedParty in the subject.

Title	Description	Type	Format
`type`		string
Type of Interest	The nature of the interest, using the interestType codelist. See Interest Type
`directOrIndirect`		string
Direct or Indirect	How directly the interest is exercised by the interested party. The value MUST be ‘indirect’ if intermediate entities or agents are known to exist, and MUST be ‘direct’ if such intermediaries are known not to exist. Otherwise the value MUST be ‘unknown’.
`beneficialOwnershipOrControl`		boolean
Beneficial Ownership or Control	Whether this interest (alone or with others) means the interested party is a beneficial owner of the subject. If ‘true’ the interested party MUST be a natural person. The definition of ‘beneficial owner’ in operation SHOULD be noted in accompanying guidance (such as a publication policy or data use guide).
`details`		string
Details	The local name given to this kind of interest, or further information (semi-structured or unstructured) to clarify the nature of the interest.
`share`		object
Percentage Share	The proportion of this type of interest held by the interested party, where an interest is countable. Provide the `exact` percentage if known. Otherwise, `minimum` (or `exclusiveMinimum`) and `maximum` (or `exclusiveMaximum`) can be used to record the range into which the proportion falls. (The `minimum` and `maximum` values are inclusive.) See Share
`startDate`		string	date
Start Date	The date from which this interest was active. The date MUST be given in YYYY-MM-DD format. Where a precise month or date are unknown, the value may be rounded to the first day of the (first) month. This rounding SHOULD be noted in accompanying guidance (such as a publication policy or data use guide).
`endDate`		string	date
End Date	The date from which this interest ceased to exist. The date MUST be given in YYYY-MM-DD format. Where a precise month or date are unknown, the value may be rounded to the first day of the (first) month. This rounding SHOULD be noted in accompanying guidance (such as a publication policy or data use guide).

Jurisdiction¶

A Jurisdiction MUST have a name. A jurisdiction SHOULD have a 2-letter country code (ISO 3166-1) or a subdivision code (ISO 3166-2).

Title	Description	Type	Required
`name`		string	Required
Name	The name of the jurisdiction
`code`		string
Country or Subdivision Code	The 2-letter country code (ISO 3166-1) or the subdivision code (ISO 3166-2) for the jurisdiction.

Name¶

A name by which this person is known. A name MUST be provided in `fullName`, and MAY be broken down in the `familyName`, `givenName` and `patronymicName` fields, based on the EC ISA Core Person Vocabulary (https://joinup.ec.europa.eu/solution/e-government-core-vocabularies) definitions.

Title	Description	Type	Required
`type`		string
Type	The status of this name for the person, using the nameType codelist. See Name Type
`fullName`		string	Required
Full Name	The complete name of the person.
`familyName`		string
Family Name	Part of the person’s `fullName` which is shared by family members. The value may include prefixes or suffixes, e.g. ‘de Boer’, ‘van de Putte’, ‘von und zu Orlow’. The value may be a multiple-part family name, such as are commonly found in Hispanic countries. For example, Miguel de Cervantes Saavedra’s Family Name would be recorded as ‘de Cervantes Saavedra.’
`givenName`		string
Given Names	The part of the person’s `fullName` that identifies the person within their family. These are given to a person by their parents at birth or may be legally recognised as ‘given names’ through a formal process. For example, the given name for Johann Sebastian Bach is ‘Johann Sebastian’.
`patronymicName`		string
Patronymic Name	Part of the person’s `fullName` which is inherited from their father, as is common in countries such as Iceland, Ethiopia and Russia. For example, the ‘Sergeyevich’ in ‘Mikhail Sergeyevich Gorbachev’.

PEPstatusDetails¶

Information about a person’s political involvement.

Title	Description	Type	Format
`reason`		string
Reason	The reason for this person being declared a politically-exposed person.
`missingInfoReason`		string
Missing Information Reasons	An explanation of why the PEP status for the person is not provided (i.e. `politicalExposure.status` is ‘unknown’). This may be a standard descriptive phrase from the source system, or a free text justification. Where this field is present it should be the only field except for `source`.
`jurisdiction`		object
Jurisdiction	The jurisdiction where this person is a PEP. See Jurisdiction
`startDate`		string	date
State Date	The date from which this person had the status of a Politically-exposed Person (PEP). The date MUST be given in YYYY-MM-DD format. Where a precise month or date are unknown, the value may be rounded to the first day of the (first) month. This rounding SHOULD be noted in accompanying guidance (such as a publication policy or data use guide).
`endDate`		string	date
End Date	The date from which this person no longer had the status of a Politically-exposed Person (PEP). The date MUST be given in YYYY-MM-DD format. Where a precise month or date are unknown, the value may be rounded to the first day of the (first) month. This rounding SHOULD be noted in accompanying guidance (such as a publication policy or data use guide).
`source`		object
Source	The source of this PEP information See Source

PublicListing¶

Details of a publicly listed company, its securities (shares and other tradable financial instruments related to the entity), and related regulatory filings.

Title	Description	Type	Required
`hasPublicListing`		boolean	Required
Has Public Listing	Whether the entity is a publicly listed company.
`companyFilingsURLs`		array[string]
Company Filings URLs	URL or URLs where regulatory filings related to major holdings can be retrieved. URLs may point to pages maintained by regulatory bodies, stock exchanges or by the company itself.
`securitiesListings`		array[Securities listing]
Securities Listings	Details of the entity’s securities and the public exchanges and markets on which they are traded. All equity securities SHOULD be listed here, plus any other securities from which beneficial ownership might be derived. Where a security is traded on more than one market, there SHOULD be an entry for each market (or market segment). See SecuritiesListing

Publication Details¶

Information concerning the publication of this Statement.

Title	Description	Type	Format	Required
`publicationDate`		string		Required
Publication date	The date on which this statement was published, in full-date (YYYY-MM-DD) or date-time (e.g. YYYY-MM-DDTHH:MM:SSZ) format. See the IETF RFC3339 standard, section 5.6.
`bodsVersion`		string		Required
BODS Version	The version of the Beneficial Ownership Data Standard to which this Statement conforms, expressed as major.minor (e.g. 0.2 or 1.0). In a published BODS dataset, all Statements MUST have the same major version number.
`license`		string	uri
License URL	A link to the license that applies to this Statement. The canonical URI of the license SHOULD be used. Publishers are encouraged to use a Public Domain Dedication or Open Definition Conformant (http://opendefinition.org/licenses/) license.
`publisher`		object		Required
Publisher	Details of the organisation or person publishing a Statement.

Publisher¶

Details of the organisation or person publishing a Statement.

Title	Description	Type	Format
`name`		string
Name	The name of the publisher.
`url`		string	uri
URL	The URL where details of the full dataset, or of the publisher, can be found.

Record Details (entity)¶

Information about an entity.

Title	Description	Type	Format	Required
`isComponent`		boolean		Required
Is component	Whether this entity is a component in an indirect relationship. Where `isComponent` is ‘true’: (1) the `recordId` of this entity MUST be an element in the `componentRecords` array of that primary Relationship Statement, (2) this Entity Statement MUST come before that primary Relationship Statement in a BODS package or stream, (3) the replacement of this Entity Statement SHOULD be considered when replacing the primary Relationship Statement. The primary Relationship statement MUST have a `isComponent` value of ‘false’.
`entityType`		object		Required
Entity Type	The form of the entity described in the Statement.
`entityType/type`		string		Required
Type	The general form of the entity, using the entityType codelist. See Entity Type
`entityType/subtype`		string
Subtype	The particular form of the entity, where relevant, using the entitySubtype codelist. The value MUST align with the `entityType` value. See Entity Subtype
`entityType/details`		string
Details	This may be used to provide a local name for this type of entity, or any further information to identify the type of entity. For example, in Finland ‘ministeriö’ for a government department.
`unspecifiedEntityDetails`		object
Unspecified or unknown person or entity	An explanation of why an entity is anonymous or unknown. See UnspecifiedRecord
`name`		string
Entity Name	The declared name of this entity.
`alternateNames`		array[string]
Alternative Names	An array of other names this entity is known by.
`jurisdiction`		object
Jurisdiction	The jurisdiction in which this entity was registered or created (for legal and registered entities, and arrangements). Or the state’s jurisdiction (for states and state bodies). See Jurisdiction
`identifiers`		array[Identifier]
Identifiers	One or more official identifiers for this entity. Where available, official registration numbers should be provided. See Identifier
`foundingDate`		string	date
Founding Date	The date on which this entity was founded, created or registered. The date MUST be given in YYYY-MM-DD format. Where a precise month or date are not available, the value may be rounded to the first day of the (first) month. This rounding SHOULD be noted in accompanying guidance (such as a publication policy or data use guide).
`dissolutionDate`		string	date
Dissolution Date	The date on which this entity was dissolved or ceased, if it is no longer active. The date MUST be given in YYYY-MM-DD format. Where a precise month or date are not available, the value may be rounded to the first day of the (first) month. This rounding SHOULD be noted in accompanying guidance (such as a publication policy or data use guide).
`addresses`		array[Address]
Addresses	One or more addresses for this entity. See Address
`uri`		string	uri
URI	Where a persistent URI (https://en.wikipedia.org/wiki/Uniform_Resource_Identifier) is available for this entity this should be included.
`publicListing`		object
Public Listing	Details of a publicly listed company, its securities (shares and other tradable financial instruments related to the entity), and related regulatory filings. See PublicListing
`formedByStatute`		object
Formed by Statute	The law which mandated the formation of the entity described in the statement, where applicable. This information SHOULD be provided where a state has created an agency or other entity with specific legislation.
`formedByStatute/name`		string
Statute Name	The name of the law.
`formedByStatute/date`		string	date
Date	The date on which the law came into force. The date MUST be given in YYYY-MM-DD format. Where a precise month or date are not available, the value may be rounded to the first day of the (first) month. This rounding SHOULD be noted in accompanying guidance (such as a publication policy or data use guide).

Record Details (person)¶

Information about a natural person.

Title	Description	Type	Required
`isComponent`		boolean	Required
Is component	Whether this person is a component of an indirect relationship. Where `isComponent` is ‘true’: (1) the `recordId` of this person MUST be an element in the `componentRecords` array of that primary Relationship Statement, (2) this Person Statement MUST come before that primary Relationship Statement in a BODS package or stream, (3) the replacement of this Person Statement SHOULD be considered when replacing the primary Relationship Statement. The primary Relationship Statement MUST have a `isComponent` value of ‘false’.
`personType`		string	Required
Person Type	The status of this person, using the personType codelist. Where a person has the type ‘anonymousPerson’ or ‘unknownPerson’ a reason for the absence of information SHOULD be provided in ‘unspecifiedPersonDetails’ See Person Type
`unspecifiedPersonDetails`		object
Unspecified or unknown person or entity	An explanation of why a person is anonymous or unknown. See UnspecifiedRecord
`names`		array[Name]
Names	One or more known names for this person. See Name
`identifiers`		array[Identifier]
Identifiers	One or more official identifiers for this person. Where available, official registration numbers should be provided. See Identifier
`nationalities`		array[Country]
Nationality	The nationalities held by this person. See Country
`placeOfBirth`		object
Place of Birth	The place where this person was born. See Address
`birthDate`		string
Date of Birth	The date of birth for this person, in YYYY, YYYY-MM, or YYYY-MM-DD format.
`deathDate`		string
Death Date	The date of death for this person, in YYYY, YYYY-MM, or YYYY-MM-DD format.
`taxResidencies`		array[Country]
Tax Residency	The tax residencies held by this person, as an array of Country objects. See Country
`addresses`		array[Address]
Addresses	One or more addresses for this person. See Address
`politicalExposure`		object
Political Exposure	Information about whether, and how, the person described by this statement is politically exposed. Use this property only if politically exposed person (PEP) declarations are expected as part of beneficial ownership declarations.
`politicalExposure/status`		string	Required
Politically Exposed Person (PEP) Status	This value is ‘isPep’ or ‘isNotPep’ according to whether the person described by this statement has the status of politically exposed person (PEP). An ‘unknown’ value means a PEP status declaration is expected but missing; the reason for the missing data SHOULD be supplied in the `details` array.
`politicalExposure/details`		array[PEP Status Details]
Politically Exposed Person (PEP) Details	One or more descriptions of this person’s Politically Exposed Person (PEP) status. See PepStatusDetails

Record Details (relationship)¶

See Representing beneficial owners for detailed requirements.

Information about the interests that an interested party (a person or entity) holds in the subject (an entity).

Title	Description	Type	Required
`isComponent`		boolean	Required
Is component	Whether this relationship is a component of a wider indirect relationship. Where `isComponent` is ‘true’: (1) the `recordId` of this secondary Relationship Statement MUST be an element in the `componentRecords` array of that primary Relationship Statement, (2) this Relationship Statement MUST come before that primary Relationship Statement in a BODS package or stream, (3) the replacement of this Relationship Statement SHOULD be considered when replacing the primary Relationship Statement, and (4) the primary Relationship Statement MUST have an `isComponent` value of ‘false’. Where `isComponent` is ‘false’, this Relationship Statement is the primary declaration of the relationship between the `subject` and the `interestedParty`.
`componentRecords`		array[string]
Component Record IDs	The `recordId` values of all component records that provide detail about this relationship between the `subject` and the `interestedParty` (if it is indirect). If this relationship has components, its own `isComponent` value MUST be ‘false’.
`subject`		object	Required
Subject	The `recordId` for the subject of the relationship, or a reason why the subject cannot be specified. The subject MUST be an entity.
`interestedParty`		object	Required
Interested Party	The `recordId` for the interested party in the relationship, or an Unspecified Record object with a reason for why this information has not been disclosed. The interested party MAY be an entity or a person. An Unspecified Record SHOULD only be used where no information at all is known about interested parties beyond this point of the beneficial ownership network. If the interested party is known to be an entity or person but their particular identity is unavailable, a `recordId` for them SHOULD be provided here (and the their `recordDetails.[person\|entity]Type` should indicate that they are anonymous or unknown).
`interests`		array[Interest]
Interests	A description of the interests held by the interested party in the subject. See Interest

Record Id¶

See Record identifiers for information about Record Ids

A unique identifier for the record (within the publisher’s system) to which this Statement relates. (A record captures information about an entity, natural person or relationship within the beneficial ownership network of a particular declaration subject.)

SecuritiesListing¶

Details of a security and the market on which it is traded.

See Real world identifiers for guidance on representing securities listings.

Title	Description	Type	Required
`marketIdentifierCode`		string
Market Identifier Code (MIC)	The Market Identifier Code (MIC) of the market on which the security is traded. Where the security is traded on a segment of an exchange, this is the MIC of the segment. Where it is traded on the main exchange, this is the MIC of the main exchange and MUST match the `operatingMarketIdentifierCode`. MICs are allocated and managed under ISO standard 10383.
`operatingMarketIdentifierCode`		string
Operating Market Identifier Code (Operating MIC)	The Market Identifier Code (MIC) of the main exchange or trading platform handling trades in this security. Where the security is traded on a segment of an exchange, this is the MIC of the parent exchange or trading platform. Where it is traded on the main exchange, this is the MIC of that main exchange and MUST match the `marketIdentifierCode`. MICs are allocated and managed under ISO standard 10383.
`stockExchangeJurisdiction`		string	Required
Stock Exchange Jurisdiction	The 2-letter country code (ISO 3166-1) or the subdivision code (ISO 3166-2) for the jurisdiction under which the exchange, market or trading platform is regulated.
`stockExchangeName`		string	Required
Stock Exchange Name	The name of the exchange, market or trading platform on which the security is traded. If the security is traded on a segment of the exchange, then the name SHOULD include both elements. For example, ‘London Stock Exchange - MTF’.
`security`		object	Required
Security	Identifying information of the stock or other security.
`security/idScheme`		string
Identifier Scheme	The scheme under which the security has been issued a unique, persistent identifier, using the securitiesIdentifierSchemes codelist. See Securities Identifier Schemes
`security/id`		string
Identifier	The unique identifier of the security as issued under the `idScheme`.
`security/ticker`		string	Required
Stock Ticker	The stock ticker identifying this security on the named stock exchange.

Share¶

The proportion of this type of interest held by the interested party, where an interest is countable. Provide the `exact` percentage if known. Otherwise, `minimum` (or `exclusiveMinimum`) and `maximum` (or `exclusiveMaximum`) can be used to record the range into which the proportion falls. (The `minimum` and `maximum` values are inclusive.)

Title	Description	Type
`exact`		number
Exact percentage	The exact share of this interest held (if available).
`maximum`		number
Maximum Percentage	The inclusive upper bound of the share of this interest.
`minimum`		number
Minimum Percentage	The inclusive lower bound of the share of this interest.
`exclusiveMinimum`		number
Exclusive Minimum percentage	The exclusive lower bound of the share of this interest.
`exclusiveMaximum`		number
Exclusive Maximum Percentage	The exclusive upper bound of the share of this interest.

Source¶

Details describing an information source.

Title	Description	Type	Format
`type`		array[string]
Source Type	The types of the source, using the sourceType codelist. Include ‘verified’ in the array if the information in the Statement has undergone a verification process. See Source Type
`description`		string
Description	Additional, free text information about the source of information.
`url`		string	uri
Source URL	The external URL from which this information was fetched, if relevant. Or, if relevant, a URL providing additional detail on how this information was sourced.
`retrievedAt`		string
Retrieved At	A timestamp indicating when this information was imported from an external system, in full-date (YYYY-MM-DD) or date-time (e.g. YYYY-MM-DDTHH:MM:SSZ) format. See the IETF RFC3339 standard, section 5.6.
`assertedBy`		array[object]
Asserted By	The people or organisations providing the information asserted in this Statement. This may include the declaring subject of a self-declaration, or the name of an agent making a declaration on their behalf. If this Statement has been verified, the array may include the name of the organisation providing verification.
`assertedBy/0/name`		string
Name	The name of the agent making the assertion
`assertedBy/0/uri`		string	uri
URI	An optional URI to identify the agent making the assertion

Statement¶

A claim about a person, entity or relationship, made at a particular point in time.

Title	Description	Type	Required
`statementId`		string	Required
Statement Identifier	A persistent globally unique identifier for this Statement. Length MUST be 32 - 64 characters (inclusive). See Statement Id
`statementDate`		string	Required
Statement Date	The date on which this statement was declared by the source, in full-date (YYYY-MM-DD) or date-time (e.g. YYYY-MM-DDTHH:MM:SSZ) format. See the IETF RFC3339 standard, section 5.6.
`annotations`		array[Annotation]
Annotations	Annotations about this Statement or parts of this Statement See Annotation
`publicationDetails`		object
Publication Details	Information concerning the publication of this Statement. See Publication Details
`source`		object
Source	The source of information in this statement. Each statement SHOULD contain source information. See Source
`declaration`		string
Declaration Reference	An identifier or reference for a declaration within the publisher’s system. Where a Statement is a claim from a particular declaration (made at a point in time by a `source` about a `declarationSubject`) this field identifies the declaration.
`declarationSubject`		string	Required
Declaration Subject	A `recordId` value for the subject of a beneficial ownership network (always an entity or person).
`recordId`		string	Required
Record Identifier	A unique identifier for the record (within the publisher’s system) to which this Statement relates. (A record captures information about an entity, natural person or relationship within the beneficial ownership network of a particular declaration subject.) See Record Id
`recordType`		string	Required
Record Type	The type of record (within the publisher’s system) to which this Statement relates: entity, person, or relationship.
`recordStatus`		string
Record Status	The lifecycle status of the record (within the publisher’s system) to which this Statement relates, using the recordStatus codelist. See Record Status
`recordDetails`		object	Required
Record Details	The details of the entity, person or relationship as declared on the Statement Date. See Record details

Statement Id¶

See Generating statements for advice on generating unique Statement Ids

A persistent globally unique identifier for this Statement. Length MUST be 32 - 64 characters (inclusive).

UnspecifiedRecord¶

A `reason` MUST be supplied.

Title	Description	Type	Required
`reason`		string	Required
Reason	The reason that a person or entity cannot be specified, using the unspecifiedReason codelist. See Unspecified Reason
`description`		string
Description	Additional information about the absence of details for a person or entity. This field may be used to provide set phrases from a source system, or a free text explanation.

Codelists¶

Address Type¶

code	title	description
placeOfBirth	Place of birth	The place where a person was born. A town (in the address field) and country may be sufficient information. This MUST only apply to the placeOfBirth field for natural persons.
residence	Residential address	An address where someone lives. This MUST only apply to natural persons.
registered	Registered address	An official address for delivering statutory mail and legal notices which must be provided to company registers. This MUST only apply to entities.
service	Service address	An address which can be used as an alternative to a residential address for the purpose of receiving post. This MUST only apply to natural persons.
alternative	Alternative address	An address provided in addition to the primary address for this entity or person that is neither a service nor a registered address.
business	Business address	A place where the entity conducts its business.

Annotation Motivation¶

code	title	description
commenting	Commenting	The description field provides contextual comments for a field, object or statement.
correcting	Correcting	The value of this field, object or statement has been corrected, using the method in the description field or from the original value given in the description field.
identifying	Identifying	The value of this field, object or statement has been augmented or processed for the purpose of identifying natural persons or legal entities, using the method in the description field.
linking	Linking	The description explains how linked material relates to the field, object or statement. A URL to linked material MUST be provided in the url field.
transformation	Transformation	The values of this field, object or statement have been changed from their original form using the method in the description field. The transformed representation may be provided in the transformedContent field.

Direct Or Indirect¶

code	title	description
direct	Direct	The interest is held directly.
indirect	Indirect	The interest is held through one or more intermediate entities (including arrangements).
unknown	Unknown	The interest may be direct or indirect.

Entity Type¶

code	title	description
registeredEntity	Registered Entity	A legal entity created through an act of official registration. In most cases, registered entities have an officially issued identifier.
legalEntity	Legal entity	A body with distinct legal personality, such as an international institution or statutory corporation, but which is not otherwise uniquely identified in some official register.
arrangement	Arrangement	A legal arrangement, agreement, contract or other mechanism via which one or more natural or legal persons can associate to exert ownership or control over an entity. Parties to an arrangement have no other form of collective legal identity.
anonymousEntity	Anonymous entity	An entity that has been identified, but for which identifying information is being withheld. The reason for non-disclosure should be given in the accompanying unspecifiedEntityDetails field.
unknownEntity	Unknown entity	An entity that has not been identified.
state	State	A country, nation or community with legal sovereignty within a territory.
stateBody	State body	A core administrative or legislative unit within a state’s apparatus.

Entity Subtype¶

code	title	description
governmentDepartment	Government department	An element of government with executive responsibilities. These terms are often used to designate such a body: ministry, department, bureau or office. This MUST be used with entityType.type ‘stateBody’.
stateAgency	State Agency	A body overseeing or administering elements of public policy. State agencies may have responsibilities which are devolved from government departments or from the state’s legislative body. This MUST be used with entityType.type ‘stateBody.
other	Other	Any other type of entity.
trust	Trust	A trust or trust like arrangement. An arrangement where a settlor transfers ownership of assets to trustees to control for the benefit of beneficiaries. This MUST be used with entityType.type ‘arrangement’ or ‘legalEntity’.
nomination	Nomination	An agreement where a nominator instructs a nominee to act on their behalf in a specified capacity. This MUST be used with entityType.type ‘arrangement’.

Interest Type¶

code	title	description
shareholding	Shareholding	An economic interest in an entity gained by holding shares.
votingRights	Voting rights	A controlling interest in an entity gained by holding shares. Defined as the right of shareholders to vote on matters of corporate policy, including decisions on the makeup of the board of directors, issuing securities, initiating corporate actions and making substantial changes in the corporation’s operations.
appointmentOfBoard	Appointment of board	A controlling interest in an entity. Defined as the absolute right to appoint members of the board of directors.
otherInfluenceOrControl	Other influence or control	Any influence or control in an entity that is distinct from being a shareholder, having voting rights or having the absolute right to appoint to the board.
seniorManagingOfficial	Senior managing official	A controlling interest in an entity gained by employment. Defined as the person who exercises control over the management of the entity.
settlor	Settlor	A person who, either actually or by operation of law, creates a trust. They may be referred to by other names such as a trustor, a grantor or a donor. This should also be used for a person with a settlor-equivalent role in any legal arrangement that is similar to a trust.
trustee	Trustee	A person who administers a trust for the benefit of a third party and in whom the legal title of the trust property is vested either by declaration of the settlor or by operation of law. This should also be used for a person with a trustee-equivalent role in any legal arrangement that is similar to a trust.
protector	Protector	A person appointed to protect the interests or wishes of the settlor, providing influence and guidance to the trustee who administers the trust. This should also be used for a person with a protector-equivalent role in any legal arrangement that is similar to a trust.
beneficiaryOfLegalArrangement	Beneficiary of a legal arrangement	A person who benefits from a trust or other legal arrangement’s holdings or activities.
rightsToSurplusAssetsOnDissolution	Rights to surplus assets on dissolution	The right to a share in the amount of an asset or resource that exceeds the portion that is utilized upon the winding up of an entity.
rightsToProfitOrIncome	Rights to receive profits or income	An economic interest in an entity. Defined as beneficial ownership rights beyond those otherwise implied by ownership structures that are granted by contract.
rightsGrantedByContract	Rights granted by contract	An interest that is granted by contract.
conditionalRightsGrantedByContract	Conditional rights granted by contract	An interest that exists only if some contractual condition is met.
controlViaCompanyRulesOrArticles	Control via company rules or articles	Control of an entity gained through a provision in company articles or by shareholder agreement.
controlByLegalFramework	Control by legal framework	Control of an entity gained through a legal framework, such as a combination of legislation (primary and secondary). This type of interest is created by governments and legislators in order to establish and guide agencies and entities linked to the state.
boardMember	Board member	One of a group of people constituted as the strategic decision-making body of an organization.
boardChair	Board chair	The person holding the most power and authority on the board of directors.
unknownInterest	Unknown interest	The interestedParty is known to have an interest in the subject of this Relationship Statement, but the nature of the interest is unknown.
unpublishedInterest	Unpublished interest	The nature of this interest is known but is not published.
enjoymentAndUseOfAssets	Enjoyment and use of assets	The use of assets belonging to an entity.
rightToProfitOrIncomeFromAssets	Right to profit or income from assets	The right to derive profits, income or both from assets belonging to an entity.
nominee	Nominee	A person who agrees to act on behalf of the nominator in a specified capacity.
nominator	Nominator	A person who instructs a nominee to act on their behalf in a specified capacity.

Name Type¶

code	title	description
legal	Legal name	A name that identifies the person for legal, administrative and other official purposes. A person’s legal name will usually be the one that is found on official government documents.
translation	Translation of name	A translation of the person’s legal name in a different language.
transliteration	Transliteration of name	A transliteration of the person’s legal name in a different script.
former	Former name	A name that the person has used in the past.
alternative	Alternative name	Another name that the person is known by. This might be an alias, a nickname or a name that the person is also known as (aka).
birth	Birth name	The legal name of the person at birth.

Person Type¶

code	title	description
knownPerson	Known person	A natural person who has been identified, and information such as names, identifiers or biographical information can be provided about them.
anonymousPerson	Anonymous person	A natural person who has been identified, but identifying information is being withheld. The reason for non-disclosure should be given in the accompanying unspecifiedPersonDetails field.
unknownPerson	Unknown person	A natural person whose identity has not been discovered or confirmed.

Record Status¶

code	title	description
new	New Record	This is the first Statement published pertaining to the record referenced by recordId.
updated	Updated Record	This Statement updates information published in a prior Statement pertaining to the record referenced by recordId.
closed	Closed Record	This is the final Statement published pertaining to the record referenced by recordId.

Record Type¶

code	title	description	technical note
person	Person	The Record Details in this Statement contain information about a natural person at a particular point in time.	The recordDetails object should be validated using the Person Record schema.
entity	Entity	The Record Details in this Statement contain information that identifies and describes an entity at a particular point in time.	The recordDetails object should be validated using the Entity Record schema.
relationship	Relationship	The Record Details in this Statement describe the interests held by an interested party in a subject (an entity) at a particular point in time.	The recordDetails object should be validated using the Relationship Record schema.

Securities Identifier Schemes¶

code	title	description
isin	International Securities Identification Number (ISIN)	Scheme for unique identification of securities internationally. Securities are issued 12-character identifiers. Full details of the scheme are specified by ISO 6166.
figi	Financial Instrument Global identifier (FIGI)	Scheme for unique identification of securities internationally. Securities are issued 12-character identifiers. Full details of the scheme are specified as an Object Management Group standard: https://www.omg.org/spec/FIGI/.
cusip	Committee on Uniform Securities Identification Procedures (CUSIP) Number	Scheme for unique identification of securites in North America. Securities are issued 9-character identifiers. The scheme is managed by the American Bankers Association and specified as ANSI X9.6.
cins	CUSIP International Numbering System (CINS)	Scheme for unique identification of securities issued outside North America. Securities are issued 9-character identifiers. The scheme is managed by the American Bankers Association and specified as ANSI X9.6.

Source Type¶

code	title	description
selfDeclaration	Self declaration	The information was provided by the person or entity referred to from declarationSubject, or by their authorised representative.
officialRegister	Official register	The information was taken from an official register.
thirdParty	Third party	The information was provided by a third party, not directly related to the person, entity or interests described by this statement.
primaryResearch	Primary research	The information was provided as a result of research into primary sources.
verified	Verified	The information has been verified through the process documented in the associated description.

Unspecified Reason¶

code	title	description
noBeneficialOwners	No beneficial owners	There are no beneficial owners who need to disclose ownership according to the rules under which this statement is made.
subjectUnableToConfirmOrIdentifyBeneficialOwner	Subject unable to confirm or identify beneficial owner	The subject of this Relationship Statement has, as the disclosing party, been unwilling or unable to confirm the existence identify a beneficial owner.
interestedPartyHasNotProvidedInformation	Interested party has not provided information	The interested party in this Relationship Statement has not provided enough information to identify or confirm the identity of the beneficial owner.
subjectExemptFromDisclosure	Subject exempt from disclosure	The subject of this Relationship Statement is not required to disclose its beneficial owner.
interestedPartyExemptFromDisclosure	Interested party exempt from disclosure	The interested party in this Relationship Statement is exempt from having their identity disclosed.
unknown	Unknown reason	The reason an interested party cannot be provided is not known.
informationUnknownToPublisher	Information unknown to the publisher of the data	A publisher does not have access to information on this person or entity. This should not generally be used in situations where one party has the responsibility to provide such information.