--- title: "Retrieve Company Details" method: GET path: "/companies/{id}/" tags: ["Companies"] --- # Retrieve Company Details `GET /companies/{id}/` ## Request - Base URL: `https://api.financialreports.eu` - URL: `https://api.financialreports.eu/companies/{id}/` - Auth: one of: - API key in header `X-API-Key` - HTTP bearer **Access Level Required:** Requires **Standard Access (Level 1)**. --- Retrieve detailed information for a single company by its internal ID. ## Path parameters - `id` integer, required ## Response `200` Success - Company - `id` integer, required: Unique identifier for the company. - `name` string, required: Company name. - `tagline` string, required: A short, one-liner describing the company's value proposition. - `description` string, required: A detailed description or 'About Us' text for the company. - `description_last_updated` string, date-time, nullable, required: Timestamp of the last update to the company's description. - `isins` string[], required: ISINs associated with the company (capped at 100; use the ISIN endpoint for the full list). - `isin_count` integer, required: Total number of ISINs associated with this company. - `primary_isin` string, nullable, required: The company's primary ISIN (ISO 6166), or null when no primary is designated. Equivalent to isins[0] when a primary exists. - `lei` string, required: Legal Entity Identifier (ISO 17442). - `country_code` string, required: ISO 3166-1 alpha-2 country code of the company's primary registration or headquarters. - `address` string, required: The company's primary street address. - `city` string, required: The city where the company's headquarters is located. - `zip_code` string, required: The postal or ZIP code for the company's address. - `sector` ISICSection, required - `code` string, required: ISIC Section code. - `name` string, required: ISIC Section name. - `industry_group` ISICDivision, required - `code` string, required: ISIC Division code. - `name` string, required: ISIC Division name. - `sector` ISICSection, required - `code` string, required: ISIC Section code. - `name` string, required: ISIC Section name. - `industry` ISICGroup, required - `code` string, required: ISIC Group code. - `name` string, required: ISIC Group name. - `industry_group` ISICDivision, required - `code` string, required: ISIC Division code. - `name` string, required: ISIC Division name. - `sector` ISICSection, required - `code` string, required: ISIC Section code. - `name` string, required: ISIC Section name. - `sub_industry` ISICClass, required - `code` string, required: ISIC Class code. - `name` string, required: ISIC Class name. - `industry` ISICGroup, required - `code` string, required: ISIC Group code. - `name` string, required: ISIC Group name. - `industry_group` ISICDivision, required - `code` string, required: ISIC Division code. - `name` string, required: ISIC Division name. - `sector` ISICSection, required - `code` string, required: ISIC Section code. - `name` string, required: ISIC Section name. - `oics` CompanyOics, required: A company's label under the Open Industry Classification Standard (OICS): its primary class with the class's sector, industry group and industry, its entity type and up to two secondary classes. Public preview, OICS v0.3. - `code` string, nullable, required: Primary class code: the class's place in the tree, SECTOR.GROUP.INDUSTRY.CLASS (e.g. `TC.SC.SEM.CHP`). Null for an entity type that carries no class. - `name` string, nullable, required: Primary class name. Null when `code` is. - `sector` OicsNodeRef, required: A node of the OICS tree, or an entity type, by code and English name. - `code` string, required: Code. - `name` string, required: Name, in English. - `group` OicsNodeRef, required: A node of the OICS tree, or an entity type, by code and English name. - `code` string, required: Code. - `name` string, required: Name, in English. - `industry` OicsNodeRef, required: A node of the OICS tree, or an entity type, by code and English name. - `code` string, required: Code. - `name` string, required: Name, in English. - `entity_type` string, required: What kind of entity the company is, decided before its activity: OPERATING, HOLDING, FUND, SPAC_SHELL, FINANCING_VEHICLE or PUBLIC_SECTOR. FUND, SPAC_SHELL, FINANCING_VEHICLE and PUBLIC_SECTOR carry no class; a HOLDING carries one only when most of its value sits in one business. - `secondaries` OicsNodeRef[], required: Up to two further classes the company has a material business in. Never the primary. - `code` string, required: Code. - `name` string, required: Name, in English. - `basis` string, required: What the label rests on: `revenue` (reported revenue by segment or product), `nav` (a holding's net asset value), `filings` (other figures from the company's filings) or `description` (the company's description). - `taxonomy_version` string, required: OICS version the label was decided under, e.g. `0.3`. - `classified_at` string, date-time, nullable, required: When the label was last written (ISO 8601, UTC). - `contested` boolean, required: True when an independent second reading disagreed with the label: of the company's description, for a label with basis `description`, or a second mapping of its revenue lines, for a label decided on reported revenue. The label stands; `alternate` is the other reading. A label decided on other figures from the company's filings is never contested. - `alternate` OicsNodeRef, required: A node of the OICS tree, or an entity type, by code and English name. - `code` string, required: Code. - `name` string, required: Name, in English. - `ir_link` string, uri, nullable, required: Link to the company's Investor Relations page. - `homepage_link` string, uri, nullable, required: Link to the company's main homepage. - `logo` string, uri, nullable, required: URL of the company's logo file. - `date_public` string, date, nullable, required: Date this company record was last updated on the FinancialFilings platform. This is NOT the IPO date — see `date_ipo` instead. - `date_ipo` string, date, nullable, required: Date of the company's Initial Public Offering (IPO). Returns null when the IPO date is unknown. - `main_stock_exchange` string, nullable, required: URL of the company's listing page on its main stock exchange, where known; empty for most companies. Not a MIC: exchange codes are in `listings`. - `is_listed` boolean, nullable, required: Indicates if the company is currently publicly listed. - `listing_status` string, required: Canonical exchange-listing state. One of: LISTED, DELISTED, SUSPENDED, UNKNOWN. The boolean `is_listed` is derived from this (False only when DELISTED). - `delisting_date` string, date, nullable, required: Date the company was delisted, if known. Null while listed. - `delisting_reason` string, required: Reason for delisting when DELISTED: ACQUISITION, BANKRUPTCY, GOING_PRIVATE, REGULATORY, VOLUNTARY, EXCHANGE_TRANSFER, MATURED, OTHER. Empty string while listed. - `social_facebook` string, uri, nullable, required: Facebook page URL. - `social_instagram` string, uri, nullable, required: Instagram profile URL. - `social_twitter` string, uri, nullable, required: X (Twitter) profile URL. - `social_linkedin` string, uri, nullable, required: LinkedIn company page URL. A few omit the scheme (`linkedin.com/company/...`). - `social_youtube` string, uri, nullable, required: YouTube channel URL. - `social_tiktok` string, uri, nullable, required: TikTok profile URL. - `social_pinterest` string, uri, nullable, required: Pinterest profile URL. - `social_xing` string, uri, nullable, required: Xing company profile URL. - `social_glassdoor` string, uri, nullable, required: Glassdoor company page URL. - `year_founded` string, date, nullable, required: Date the company was founded. - `corporate_video_id` string, nullable, required: Identifier for a corporate video (e.g., YouTube ID). - `served_area` string, nullable, required: Geographical area served by the company. - `headcount` integer, nullable, required: Approximate number of employees. - `contact_email` string, email, nullable, required: General contact email address. - `ticker` string, nullable, required: Primary stock ticker symbol. - `local_company_id` string, nullable, required: Local registration or jurisdiction-specific ID (e.g., HRB 24902, CIK 123456). - `shares_outstanding` integer, nullable, required: Number of the company's shares outstanding, as last reported. - `designated_sponsor` DesignatedSponsor[], required: Financial institutions that act as market makers for the company's stock. - `id` integer, required: Unique identifier for the sponsor. - `name` string, required: Name of the sponsoring institution. - `listed_stock_exchange` ListedStockExchange[], required: A list of stock exchanges where the company is listed. - `id` integer, required: Unique identifier for the exchange. - `name` string, required: Name of the exchange. - `ticker` string, required: Short code of the exchange. - `website` string, uri, required: Website of the exchange. - `stock_index` StockIndex[], required: A list of stock indices the company is a component of. - `id` integer, required: Unique identifier for the index. - `name` string, required: Name of the index. - `ticker` string, required: Ticker of the index. - `isin` string, required: ISIN of the index. - `listings` CompanyListing[], required: 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. - `mic` string, nullable, required: ISO 10383 Market Identifier Code of the venue. - `ticker` string, required: Ticker on that venue. - `exchange_name` string, nullable, required: Name of the venue. - `exch_code` string, nullable, required: Short exchange code, e.g. `GY` for Xetra. - `security_type` string, nullable, required: Security type, e.g. `Common Stock`. - `figi` string, nullable, required: Financial Instrument Global Identifier (FIGI) of this listing. - `legal_status` string, required: The operational and legal registration status sourced from GLEIF (e.g., ACTIVE, INACTIVE). - `legal_form` EntityLegalForm, required - `elf_code` string, required: The 4-character ISO 20275 ELF code (e.g., XJHM). - `name` string, required: Human-readable name of the legal form. - `jurisdiction` Jurisdiction, required - `code` string, required: ISO 3166-1 or ISO 3166-2 jurisdiction code (e.g., GB, US-DE). - `name` string, required: Human-readable name of the jurisdiction. - `legal_address` string, required: The official registered legal address of the company sourced from GLEIF. - `legal_city` string, required: The city of the registered legal address sourced from GLEIF. - `legal_zip_code` string, required: The postal code of the registered legal address sourced from GLEIF. - `is_merged` boolean, required: 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/. - `merged_into` CompanyMergedInto, required: Inline schema type for `merged_into` on CompanySerializer (#1118). Deliberately two fields: the pointer exists so a consumer can repoint its own row, not so it can avoid a second request. Fetch the canonical id for the full record. - `id` integer, required: Internal id of the canonical company that replaced this one. - `name` string, required: Name of the canonical company. - `predecessors` CompanySuccessionLink[], required: Earlier issuers this company succeeded, e.g. the old parent before a holding-company reorganization. Each keeps the filings it issued, so the history before the change is under the predecessor's id. Empty when none is recorded. - `id` integer, required: Internal id of the linked company. - `name` string, required: Name of the linked company. - `kind` 'reorganization' | 'spin_off' | 'merger' | 'other', required: * `reorganization` - Reorganization * `spin_off` - Spin-off * `merger` - Merger * `other` - Other - `effective_date` string, date, nullable, required: Date the successor took over as issuer, when known. - `successors` CompanySuccessionLink[], required: Issuers that took over from this company, e.g. a new holding company that now carries the ticker. Filings after the change are under the successor's id. Empty when none is recorded. - `id` integer, required: Internal id of the linked company. - `name` string, required: Name of the linked company. - `kind` 'reorganization' | 'spin_off' | 'merger' | 'other', required: * `reorganization` - Reorganization * `spin_off` - Spin-off * `merger` - Merger * `other` - Other - `effective_date` string, date, nullable, required: Date the successor took over as issuer, when known. ## Other responses - `401`: Unauthorized - `403`: Missing or invalid API key, or the plan does not include this endpoint. - `404`: Not Found - `429`: Rate limit, plan quota or spend cap reached. --- [API](https://skmtc.dev/financialreports/apis/financialfilings-api.md) · [All operations](https://skmtc.dev/financialreports/apis/financialfilings-api/llms.txt) · [OpenAPI document](https://skmtc.dev/financialreports/apis/financialfilings-api/revisions/a780251d6b05?raw)