Skip to content

Update BODS example to 0.4 #1747

@jpmckinney

Description

@jpmckinney

(Not a priority. I had prepared this for separate guidance, but we are not using it there.)

Using the 0.4 data from https://bods-data.openownership.org/source/uk_version_0_4/

This example shows the beneficial ownership data for the supplier from the contract award: T.M. ENGINEERS (MIDLANDS) LIMITED and includes 3 components:

An entity record that describes the company and includes the company number: 00507062. This is the same organization identifier used in the OCDS data.

{
  "statementId": "37733760-89a9-f9c8-c48d-1d79d8662e5e",
  "declarationSubject": "GB-COH-00507062",
  "statementDate": "2023-07-30",
  "recordId": "GB-COH-00507062",
  "recordStatus": "new",
  "recordType": "entity",
  "recordDetails": {
    "name": "TM 2024 REALISATIONS LIMITED",
    "alternateNames": ["T.M. ENGINEERS (MIDLANDS) LIMITED"],
    "entityType": {"type": "registeredEntity", "details": "Private Limited Company"},
    "jurisdiction": {"name": "United Kingdom", "code": "GB"},
    "identifiers": [
      {
        "id": "00507062",
        "scheme": "GB-COH",
        "schemeName": "Companies House",
        "uri": "https://www.gov.uk/government/organisations/companies-house"
      }
    ],
    "foundingDate": "1952-04-17",
    "addresses": [{"address": "AZZURRI HOUSE WALSALL BUSINESS PARK …", }],
    "uri": "http://business.data.gov.uk/id/company/00507062",
    "publicListing": {"hasPublicListing": false},
    "isComponent": false
  },
  "annotations": [{"url": "http://business.data.gov.uk/id/company/00507062", }],
  "publicationDetails": {"publicationDate": "2025-03-05", },
  "source": {"assertedBy": [{"name": "Companies House", … ], … }]
  }
}

A relationship record that describes the relationship between an interested party and the company.

{
  "statementId": "cbdc0008-d34b-4c6c-6de2-01d9348b38fd",
  "declarationSubject": "GB-COH-00507062",
  "statementDate": "2016-07-30",
  "recordId": "GB-COH-REL-00507062-VkgvU2fQ_y1zmDPNnYSpfG-at7k",
  "recordStatus": "new",
  "recordType": "relationship",
  "recordDetails": {
    "subject": "GB-COH-00507062",
    "interestedParty": "GB-COH-PER-00507062-VkgvU2fQ_y1zmDPNnYSpfG-at7k",
    "interests": [
      {
        "directOrIndirect": "unknown",
        "type": "shareholding",
        "beneficialOwnershipOrControl": true,
        "startDate": "2016-07-30",
        "details": "Relationship Type: ['ownership-of-shares-75-to-100-percent']",
        "share": {"maximum": 100, "minimum": 75}
      }
    ],
    "isComponent": false
  },
  "publicationDetails": {"publicationDate": "2025-03-05", },
  "source": {"assertedBy": [{"name": "Companies House", … ], … }]
}

A person's record that includes the details of the beneficial owner of the company.

{
  "statementId": "2141f172-d26b-5de8-854b-bedc07982051",
  "declarationSubject": "GB-COH-00507062",
  "statementDate": "2016-07-30",
  "recordId": "GB-COH-PER-00507062-VkgvU2fQ_y1zmDPNnYSpfG-at7k",
  "recordStatus": "new",
  "recordType": "person",
  "recordDetails": {
    "personType": "knownPerson",
    "names": [
      {
        "type": "legal",
        "fullName": "Mr Robert Martin Holland",
        "familyName": "Holland",
        "givenName": "Robert Martin"
      }
    ],
    "nationalities": [{"name": "United Kingdom", "code": "GB"},
    "taxResidencies": [{"name": "United Kingdom", "code": "GB"},
    "addresses": [{"address": "Azzurri House, Walsall Business Park …", }],
    "birthDate": "1941-01",
    "isComponent": false
  },
  "publicationDetails": {"publicationDate": "2025-03-05", },
  "source": {"assertedBy": [{"name": "Companies House", … ], … }]
}

Metadata

Metadata

Assignees

No one assigned

    Labels

    Focus - ExamplesRelating to examples in the guidance

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions