/shares/company
GET/shares/companyapplication/json · application/xml · text/csv
Requires your access key in the X-Dataflow-Key header (or key query parameter). Which parameters and response fields are available to you depends on your contract; your personal OpenAPI spec from /resources/open-api shows your exact surface.
curl -H "X-Dataflow-Key: $DATAFLOW_KEY" \
"https://dataflow.modularfinance.com/api/shares/company"Query parameters
| Parameter | Type | Description |
|---|---|---|
| countries | string[] | Filter to companies listed in these countries (ISO 3166-1 alpha-2, e.g. 'SE'). |
| market-segment-ids | integer[] | Filter to companies listed on these market segments. |
| date | string | Snapshot date (YYYY-MM-DD). Defaults to the most recent data. |
Response
An array of SharesCompanyShares rows, streamed for JSON and CSV.
| Field | Type | Description |
|---|---|---|
| company_id | integer | Modular Finance company identifier. |
| company_name | string | Company name. |
| country | string | Country where the company is listed (ISO 3166-1 alpha-2). |
| date | string | Date of this snapshot (YYYY-MM-DD). |
| lei | string | Legal Entity Identifier (LEI) of the company. |
| market_segment_ids | integer[] | Identifiers of those market segments. |
| market_segments | string[] | Market segments the company's stocks trade on. |
| market_shares | integer | Tradeable shares across all share classes under the market perspective, excluding the company's own holdings. |
| market_votes | number | Total votes for the company under the market perspective. |
| market_votes_rounded | number | market_votes rounded to a whole number. |
| mic | string[] | Market Identifier Codes (ISO 10383) of the trading venues. |
| regulatory_shares | integer | Issued shares across all share classes under the regulatory perspective, including the company's own holdings. |
| regulatory_votes | number | Total votes for the company under the regulatory perspective. |
| regulatory_votes_rounded | number | regulatory_votes rounded to a whole number. |
| treasury_shares | integer | Shares held by the company itself (its treasury owner). Subtract from regulatory_shares to get outstanding shares. |