Find a company
company_lookupResolve a ticker, CIK, FinancialMD id or company name to the company FinancialMD covers, so later calls can use a stable identifier. Identifiers (ticker:AAPL, cik:320193, fmd_...) resolve directly and return the profile with meta.company showing what matched; a free-text name searches the directory and returns candidates with their ids, tickers and listings. Use this first when you are not sure of the ticker, or when a ticker is ambiguous across exchanges (ticker:AAPL.XNAS pins the venue). Issuers on EU and UK regulated markets that do not file with the SEC are covered too: they have no CIK, each candidate carries registry "esef" and an lei, and later calls take lei: or the fmd_id. Statements and filings work for them, in the reporting currency; ownership, prices, events and segments answer not_covered.
Example tool call
This call uses example arguments supplied in the tool’s input schema.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"query": "AAPL"
},
"name": "company_lookup"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum number of periods or items to return (default 10, at most 50). | |
| query | Yes | Ticker, "cik:<n>", "lei:<LEI>", "fmd_<id>", or a company name such as "Apple". | |
| country | No | Optional ISO 3166-1 alpha-2 filter for name searches. | |
| exchange | No | Optional exchange MIC filter for name searches (for example XNAS, XNYS). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | No | For an identifier: the company profile. For a name: { items: [{ fmd_id, cik, name, country, registry, lei, reporting_template, status, primary_ticker, primary_mic, available_datasets }], next_cursor }. | |
| meta | No | Request metadata: request_id, as_of, company resolution, coverage, pipeline_version, licence, terms, proof_base. | |
| error | No | Present only on isError results: the API error code and message plus remedy hints. |