Retrieve Company Details
companies_retrieveRead-onlyIdempotent
Retrieve detailed information for a single company by its internal ID.
When to use this tool: Use to get full company metadata (LEI, description, address and city, social links, stock exchanges, indices) after resolving the ID via companies_list.
When NOT to use this tool: Don't use for financial data — use companies_financials_retrieve. Don't use just to confirm a company exists — companies_list already returns enough for identification.
Examples:
What's the LEI for ASML? -> id= (Returns lei field)
[Server current date: 2026-10-09 — treat this as today.]
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | Unique identifier for the company. | |
| lei | No | Legal Entity Identifier (ISO 17442). | |
| city | No | The city where the company's headquarters is located. | |
| logo | No | URL of the company's logo file. | |
| name | No | Company name. | |
| isins | No | ISINs associated with the company (capped at 100; use the ISIN endpoint for the full list). | |
| sector | No | Company's ISIC Section classification. | |
| ticker | No | Primary stock ticker symbol. | |
| address | No | The company's primary street address. | |
| ir_link | No | Link to the company's Investor Relations page. | |
| tagline | No | A short, one-liner describing the company's value proposition. | |
| date_ipo | No | Date of the company's Initial Public Offering (IPO). Returns null when the IPO date is unknown. | |
| industry | No | Company's ISIC Group classification. | |
| listings | No | Equity venue listings for this company (exchange + ticker), deduplicated by (MIC, ticker). Excludes warrants/options/futures/rights. Populated from per-venue identifier data; coverage expands over time. | |
| zip_code | No | The postal or ZIP code for the company's address. | |
| headcount | No | Approximate number of employees. | |
| is_listed | No | Indicates if the company is currently publicly listed. | |
| is_merged | No | True when this company record has been retired as a duplicate and replaced by the company in `merged_into`. Retired records are excluded from the company list but remain retrievable by id so an existing integration can discover the replacement rather than receiving a bare 404. See the merges feed at /companies/merges/. | |
| isin_count | No | Total number of ISINs associated with this company. | |
| legal_city | No | The city of the registered legal address sourced from GLEIF. | |
| legal_form | No | The ISO 20275 Entity Legal Form sourced from GLEIF. | |
| date_public | No | Date this company record was last updated on the FinancialFilings platform. This is NOT the IPO date — see `date_ipo` instead. | |
| description | No | A detailed description or 'About Us' text for the company. | |
| merged_into | No | The canonical company that replaced this one, or null when this record is live. Repoint stored references to this id. | |
| served_area | No | Geographical area served by the company. | |
| social_xing | No | Xing company profile identifier. | |
| stock_index | No | A list of stock indices the company is a component of. | |
| country_code | No | ISO 3166-1 alpha-2 country code of the company's primary registration or headquarters. | |
| jurisdiction | No | The legal jurisdiction of incorporation sourced from GLEIF. | |
| legal_status | No | The operational and legal registration status sourced from GLEIF (e.g., ACTIVE, INACTIVE). | |
| primary_isin | No | The company's primary ISIN (ISO 6166), or null when no primary is designated. Equivalent to isins[0] when a primary exists. | |
| sub_industry | No | Company's ISIC Class classification. | |
| year_founded | No | Date the company was founded. | |
| contact_email | No | General contact email address. | |
| homepage_link | No | Link to the company's main homepage. | |
| legal_address | No | The official registered legal address of the company sourced from GLEIF. | |
| social_tiktok | No | TikTok profile identifier. | |
| delisting_date | No | Date the company was delisted, if known. Null while listed. | |
| industry_group | No | Company's ISIC Division classification. | |
| legal_zip_code | No | The postal code of the registered legal address sourced from GLEIF. | |
| listing_status | No | Canonical exchange-listing state. One of: LISTED, DELISTED, SUSPENDED, UNKNOWN. The boolean `is_listed` is derived from this (False only when DELISTED). | |
| social_twitter | No | Twitter handle (without @). | |
| social_youtube | No | YouTube channel identifier. | |
| social_facebook | No | Facebook profile/page identifier. | |
| social_linkedin | No | LinkedIn company page identifier/URL path. | |
| delisting_reason | No | Reason for delisting when DELISTED: ACQUISITION, BANKRUPTCY, GOING_PRIVATE, REGULATORY, VOLUNTARY, EXCHANGE_TRANSFER, MATURED, OTHER. Empty string while listed. | |
| local_company_id | No | Local registration or jurisdiction-specific ID (e.g., HRB 24902, CIK 123456). | |
| social_glassdoor | No | Glassdoor company identifier. | |
| social_instagram | No | Instagram profile identifier. | |
| social_pinterest | No | Pinterest profile identifier. | |
| corporate_video_id | No | Identifier for a corporate video (e.g., YouTube ID). | |
| designated_sponsor | No | Financial institutions that act as market makers for the company's stock. | |
| shares_outstanding | No | The total number of a corporation's stock shares that have been authorized and issued. | |
| main_stock_exchange | No | Primary stock exchange where the company is listed. | |
| listed_stock_exchange | No | A list of stock exchanges where the company is listed. | |
| description_last_updated | No | Timestamp of the last update to the company's description. |