How does the Object table and JSON output of Global Database company ownership API function?

In this article, I will clarify the object table and JSON output specifically in the context of the Global Database company ownership API. It is important for readers to understand the structure and format of the data returned by the API in order to effectively utilize the information it provides. Therefore, I will provide a detailed explanation of the object table and JSON output and how they are used to represent company ownership data.

Object and Description

ObjectsDescription
shareholders
id
name
quantity
currency
share_value
created_at
share_type
share_price
data
group_structure
id
registration_number
selected
name
children

Here is a list of the objects in the table along with a description of each:

  • shareholders: This object represents the shareholder(s) of a company.

  • id: This object specifies a unique identifier for the shareholder.

  • name: This object specifies the name of the shareholder.

  • quantity: This object specifies the number of shares owned by the shareholder.

  • currency: This object specifies the currency in which the share value is expressed.

  • share_value: This object specifies the value of the shares owned by the shareholder.

  • created_at: This object specifies the date and time at which the shareholder information was recorded.

  • share_type: This object specifies the type of shares owned by the shareholder (e.g. common, preferred, etc.).

  • share_price: This object specifies the price of the shares at the time they were acquired.

  • data: This object contains additional data about the shareholder.

  • group_structure: This object represents the hierarchical structure of a group of companies.

  • id: This object specifies a unique identifier for the company in the group.

  • registration_number: This object specifies the registration number of the company.

  • selected: This object specifies whether the company is selected or not (true or false).

  • name: This object specifies the name of the company.

  • children: This object specifies any sub-companies that are part of the group.

The information in the table is useful because it provides a detailed breakdown of the company ownership data provided by the Global Database company ownership API. The various objects listed in the table, such as shareholders, share value, and group structure, give a comprehensive overview of the ownership structure of a company. This information can be used to understand the relationships between different shareholders and companies, as well as the value of the shares held by each shareholder. Additionally, the unique identifiers (such as the id and registration_number objects) allow for easy referencing and tracking of specific shareholders or companies within the group. Overall, the information in the table is essential for anyone looking to gain a clear understanding of the ownership structure of a company.

Explaining the JSON output

This JSON output provides information about the shareholders and group structure of a company. The "shareholders" array contains objects representing each shareholder, including their unique identifier, name, number of shares owned, currency, share value, creation date, share type, and share price. The "data" array is currently empty. The "group_structure" array contains an object representing the hierarchical structure of the company's group, including the unique identifier, registration number, selection status, and name of each company in the group, as well as any sub-companies (represented in the "children" array). The "registration_number" field at the bottom of the output specifies the registration number of the company.

{
"shareholders": [
{
"id": 45048908,
"name": "BANDENIA BANQUEROS PRIVADOS INC",
"quantity": 530000,
"currency": "GBP",
"share_value": "530,000 ORDINARY GBP 1.00",
"created_at": "2022-02-03T17:29:01.696+0000",
"share_type": "ORDINARY",
"share_price": 1.0
},
{
"id": 45048909,
"name": "BANDENIA FINANCIAL GROUP INC",
"quantity": 1700000,
"currency": "GBP",
"share_value": "1,700,000 ORDINARY GBP 1.00",
"created_at": "2022-02-03T17:29:01.698+0000",
"share_type": "ORDINARY",
"share_price": 1.0
},
//...
],
"data": [],
"group_structure": [
{
"id": 28672740,
"registration_number": "IE673949",
"selected": false,
"name": "BANDENIA GLOBAL LIMITED",
"children": [
{
"id": 25330406,
"registration_number": "06016301",
"selected": false,
"name": "BANDENIA FIDUCIARY MANAGEMENT LTD",
"children": []
},
{
"id": 28672740,
"registration_number": "08588209",
"selected": true,
"name": "BANDENIA GATEWAY LTD",
"children": []
},
{
"id": 29380240,
"registration_number": "09150992",
"selected": false,
"name": "BANDENIA OIL AND GAS LTD",
"children": []
},
//...
]
}
],
"registration_number": "08588209"
}

Conclusion

We have discussed the object table and JSON output of the Global Database company ownership API. The object table lists the various objects that are used to represent company ownership data, including shareholder information, share value, and group structure. The JSON output provides an example of how this data is structured in a specific API response. By understanding the object table and how the data is organized in the JSON output, it is possible to effectively utilize the information provided by the API to understand the ownership structure of a company.

Notes

The Global Database company ownership API is a valuable source of information about the ownership structure of companies around the world. If you are interested in accessing this data, you can request access to the API through the third party data marketplace of Worldindata. Worldindata is a platform that connects businesses with the data and APIs they need to drive innovation and make informed decisions. By requesting access to the Global Database company ownership API through Worldindata, you can easily and securely access the data you need to better understand the ownership structure of companies.