/entities/company
GET/entities/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/entities/company"Query parameters
| Parameter | Type | Description |
|---|---|---|
| countries | string[] | A list of country codes to filter by, e.g. 'US,GB,FR' |
| include-unlisted | boolean | Include companies whose stocks are not currently listed. Default false. |
| company-ids | integer[] | A list of company IDs to filter by |
| market-segment-ids | integer[] | A list of market segment IDs to filter by |
| min-mcap | number | Minimum market capitalization |
| currency | string | Currency for the min-mcap filter and the mcap output field, e.g. 'SEK'. Default 'SEK'. |
| symbols | string[] | A list of stock symbols to filter by |
Response
An array of EntitiesCompany 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). |
| industry | string | Industry classification of the company. |
| lei | string | Legal Entity Identifier (LEI) of the company. |
| local_ref | string | Local registration reference for the company (e.g. organisation number). |
| market_segments | string[] | Market segments the company's stocks trade on. |
| mcap | number | Market capitalization of the company, based on issued shares, in the currency given by the currency parameter. |
| mcap_currency | string | Currency of the mcap value (ISO 4217). |
| mics | string[] | Market Identifier Codes of all venues the company's stocks trade on. |
| owners | integer | Number of disclosed owners of the company. |
| primary_market_segment | string | The company's primary market segment. |
| primary_mic | string | Market Identifier Code (ISO 10383) of the primary trading venue. |
| sector | string | Sector classification of the company. |