list_companies

Lists publicly listed companies matching a set of properties - sector, industry, country, market segment (exchange list) and market-capitalisation range - ordered by market cap or by name. This is the tool for questions that name no company: "which Swedish health-care companies are there", "list the FTSE 100 industrials", "the 20 largest companies in the Nordics". Use search_securities instead when you already know the company's name, ticker or ISIN. The sector_id / industry_id values come from list_sectors and the market_segment_ids values from list_market_segments; call those first, because the sector taxonomy is Modular Finance's own and its names cannot be guessed. Passing a sector together with an industry from a different sector matches nothing, since the two filters are combined with AND. countries filters on where a company is LISTED, which is not always where it is incorporated. Each row carries the company_id you pass straight to the ownership, insider, buyback, short and calendar tools, plus the company's name, country of incorporation, market_country, LEI, sector, industry, primary market segment, share classes, and market capitalisation (mcap, with mcap_currency naming its unit). Because a screener puts companies from different markets in one ranked list, every mcap on the page and the min_mcap / max_mcap bounds are read in a single currency - USD unless you pass the currency argument, and the response echoes the code it used as mcap_currency. mcap is computed on total issued shares - the same basis min_mcap and max_mcap filter on, so the value and the filter always agree - and is absent for a company with no priced market cap. Results are returned a page at a time (default 20, max 50 per page); when next_cursor is present in the response, pass it back as cursor on the next call, keeping every other parameter identical, until next_cursor is absent. Successful calls may consume Dataflow credits per company actually returned; an empty result costs zero credits.