get_owner_list

Returns the largest shareholders of a publicly listed company, ordered by percentage of total share capital owned (largest first). Each row reflects the most recent verified ownership data for that owner (see valid_from). Use search_securities first to obtain the company_id. Two perspectives are supported: 'beneficial' (who ultimately benefits, e.g. an individual or family who owns through holding companies) and 'manager' (which fund manager or asset manager directly controls the position). Each owner row reports total shares held, fraction of capital, fraction of voting rights (which can differ from capital because of multi-class share structures), whether sub-holdings exist beneath the owner (has_sub_holdings, drillable via get_sub_holdings), and optionally a per-stock breakdown across share classes. Rows also carry the owner's place in its ownership chain and how it invests: owner_parent_id / owner_parent_name name the entity one level up (a fund family or manager) and are absent for a top-level owner, so their presence is how you tell a sub-fund from a parent without another call; management_type classifies the investment approach (active, passive, quantitative) and management_style refines it; cost_basis with cost_basis_currency is the owner's average acquisition cost per share, blended across share classes, directly comparable to a share price. These four are omitted where the data is not available for a row. The list can span more than one page (default limit 25, max 100 per page); when next_cursor is present in the response, pass it back as cursor on the next call to retrieve the next page until next_cursor is absent. Successful calls may consume Dataflow credits per owner row actually returned; nested stock breakdowns do not add units, and an empty result costs zero credits.