Companies

Retrieve Company Details

Access Level Required: Requires Standard Access (Level 1).

Retrieve detailed information for a single company by its internal ID.

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

Path parameters

idinteger required

A unique integer value identifying this company.

Response

Success

idinteger required

Unique identifier for the company.

namestring required

Company name.

taglinestring required

A short, one-liner describing the company's value proposition.

descriptionstring required

A detailed description or 'About Us' text for the company.

description_last_updatedstring date-time nullable required

Timestamp of the last update to the company's description.

isinsstring[] required

ISINs associated with the company (capped at 100; use the ISIN endpoint for the full list).

isin_countinteger required

Total number of ISINs associated with this company.

primary_isinstring nullable required

The company's primary ISIN (ISO 6166), or null when no primary is designated. Equivalent to isins[0] when a primary exists.

leistring required

Legal Entity Identifier (ISO 17442).

country_codestring required

ISO 3166-1 alpha-2 country code of the company's primary registration or headquarters.

addressstring required

The company's primary street address.

citystring required

The city where the company's headquarters is located.

zip_codestring required

The postal or ZIP code for the company's address.

ir_linkstring uri nullable required

Link to the company's Investor Relations page.

homepage_linkstring uri nullable required

Link to the company's main homepage.

logostring uri nullable required

URL of the company's logo file.

date_publicstring 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_ipostring date nullable required

Date of the company's Initial Public Offering (IPO). Returns null when the IPO date is unknown.

main_stock_exchangestring 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_listedboolean nullable required

Indicates if the company is currently publicly listed.

listing_statusstring required

Canonical exchange-listing state. One of: LISTED, DELISTED, SUSPENDED, UNKNOWN. The boolean is_listed is derived from this (False only when DELISTED).

delisting_datestring date nullable required

Date the company was delisted, if known. Null while listed.

delisting_reasonstring required

Reason for delisting when DELISTED: ACQUISITION, BANKRUPTCY, GOING_PRIVATE, REGULATORY, VOLUNTARY, EXCHANGE_TRANSFER, MATURED, OTHER. Empty string while listed.

social_facebookstring uri nullable required

Facebook page URL.

social_instagramstring uri nullable required

Instagram profile URL.

social_twitterstring uri nullable required

X (Twitter) profile URL.

social_linkedinstring uri nullable required

LinkedIn company page URL. A few omit the scheme (linkedin.com/company/...).

social_youtubestring uri nullable required

YouTube channel URL.

social_tiktokstring uri nullable required

TikTok profile URL.

social_pintereststring uri nullable required

Pinterest profile URL.

social_xingstring uri nullable required

Xing company profile URL.

social_glassdoorstring uri nullable required

Glassdoor company page URL.

year_foundedstring date nullable required

Date the company was founded.

corporate_video_idstring nullable required

Identifier for a corporate video (e.g., YouTube ID).

served_areastring nullable required

Geographical area served by the company.

headcountinteger nullable required

Approximate number of employees.

contact_emailstring email nullable required

General contact email address.

tickerstring nullable required

Primary stock ticker symbol.

local_company_idstring nullable required

Local registration or jurisdiction-specific ID (e.g., HRB 24902, CIK 123456).

shares_outstandinginteger nullable required

Number of the company's shares outstanding, as last reported.

legal_statusstring required

The operational and legal registration status sourced from GLEIF (e.g., ACTIVE, INACTIVE).

legal_addressstring required

The official registered legal address of the company sourced from GLEIF.

legal_citystring required

The city of the registered legal address sourced from GLEIF.

legal_zip_codestring required

The postal code of the registered legal address sourced from GLEIF.

is_mergedboolean 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/.

Changes

No recorded changes to this operation across all 2 revisions of this API.