FinancialReports
  1. Companies
FinancialReports
  • FinancialReports API Documentation
  • Companies
    • List Companies
      GET
    • Retrieve Company Details
      GET
  • Filings
    • List Filings
      GET
    • Retrieve Filing Details
      GET
  • Processed Filings
    • Retrieve Processed Filing Content
      GET
  • Filing Types
    • List Filing Types
      GET
    • Retrieve Filing Type
      GET
  • GICS Classifications
    • List GICS Sectors
      GET
    • List GICS Industry Groups
      GET
    • List GICS Industries
      GET
    • List GICS Sub-Industries
      GET
    • Retrieve GICS Sector
      GET
    • Retrieve GICS Industry Group
      GET
    • Retrieve GICS Industry
      GET
    • Retrieve GICS Sub-Industry
      GET
  • Sources
    • List Data Sources
      GET
    • Retrieve Data Source
      GET
  • Watchlist
    • Get User's Watchlist
      GET
    • Add Company to Watchlist
      POST
    • Remove Company from Watchlist
      DELETE
  • schema
    • schema_retrieve
      GET
  1. Companies

Retrieve Company Details

GET
/companies/{id}/
Companies
Retrieve detailed information for a single company by its internal ID.
Lookup by ISIN, LEI, or Ticker directly on this endpoint (e.g., using the identifier in the URL path) is not supported.
To find a company using these identifiers, please use the list endpoint with the appropriate filter query parameters, for example:
?isin=US0378331005, ?lei=HWUPKR0MPOU8FGXBT394, or ?ticker=AAPL.

Request

Path Params
id
integer 
required
Header Params
x-api-key
string 
required

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://api.financialreports.eu/companies//' \
--header 'x-api-key;'

Responses

🟢200OK
application/json
Successfully retrieved the company details.
Body
id
integer 
read-onlyrequired
Unique identifier for the company.
name
string 
read-onlyrequired
Company name.
lei
string 
read-onlyrequired
Legal Entity Identifier (ISO 17442).
country_code
string  | null 
read-onlyrequired
ISO 3166-1 alpha-2 country code of the company's primary registration or headquarters.
sector
null  | allOf {1} 
read-onlyrequired
Company's GICS Sector classification.
object (Sector) 
optional
industry_group
null  | allOf {1} 
read-onlyrequired
Company's GICS Industry Group classification.
object (IndustryGroup) 
optional
industry
null  | allOf {1} 
read-onlyrequired
Company's GICS Industry classification.
object (Industry) 
optional
sub_industry
null  | allOf {1} 
read-onlyrequired
Company's GICS Sub-Industry classification.
object (SubIndustry) 
optional
ir_link
string <uri>
read-onlyrequired
Link to the company's Investor Relations page.
homepage_link
string <uri>
read-onlyrequired
Link to the company's main homepage.
date_public
string <date> | null 
read-onlyrequired
Date the company first became public.
date_ipo
string <date>
read-onlyrequired
Date of the company's Initial Public Offering.
main_stock_exchange
string 
read-onlyrequired
Primary stock exchange where the company is listed.
social_facebook
string <uri> | null 
read-onlyrequired
Facebook profile/page identifier.
social_instagram
string <uri> | null 
read-onlyrequired
Instagram profile identifier.
social_twitter
string <uri> | null 
read-onlyrequired
Twitter handle (without @).
social_linkedin
string <uri> | null 
read-onlyrequired
LinkedIn company page identifier/URL path.
social_youtube
string <uri> | null 
read-onlyrequired
YouTube channel identifier.
social_tiktok
string <uri> | null 
read-onlyrequired
TikTok profile identifier.
social_pinterest
string <uri> | null 
read-onlyrequired
Pinterest profile identifier.
social_xing
string <uri> | null 
read-onlyrequired
Xing company profile identifier.
social_glassdoor
string <uri> | null 
read-onlyrequired
Glassdoor company identifier.
year_founded
string <date> | null 
read-onlyrequired
Date the company was founded.
corporate_video_id
string  | null 
read-onlyrequired
Identifier for a corporate video (e.g., YouTube ID).
served_area
string  | null 
read-onlyrequired
Geographical area served by the company.
headcount
integer  | null 
read-onlyrequired
Approximate number of employees.
contact_email
string <email> | null 
read-onlyrequired
General contact email address.
ticker
string  | null 
read-onlyrequired
Primary stock ticker symbol.
is_listed
boolean 
read-onlyrequired
Indicates if the company is currently publicly listed.
Example
{
    "id": 0,
    "name": "string",
    "lei": "string",
    "country_code": "string",
    "sector": {
        "code": "string",
        "name": "string"
    },
    "industry_group": {
        "code": "string",
        "name": "string",
        "sector": {
            "code": "string",
            "name": "string"
        }
    },
    "industry": {
        "code": "string",
        "name": "string",
        "industry_group": {
            "code": "string",
            "name": "string",
            "sector": {
                "code": "string",
                "name": "string"
            }
        }
    },
    "sub_industry": {
        "code": "string",
        "name": "string",
        "industry": {}
    },
    "ir_link": "http://example.com",
    "homepage_link": "http://example.com",
    "date_public": "2019-08-24",
    "date_ipo": "2019-08-24",
    "main_stock_exchange": "string",
    "social_facebook": "http://example.com",
    "social_instagram": "http://example.com",
    "social_twitter": "http://example.com",
    "social_linkedin": "http://example.com",
    "social_youtube": "http://example.com",
    "social_tiktok": "http://example.com",
    "social_pinterest": "http://example.com",
    "social_xing": "http://example.com",
    "social_glassdoor": "http://example.com",
    "year_founded": "2019-08-24",
    "corporate_video_id": "string",
    "served_area": "string",
    "headcount": 0,
    "contact_email": "user@example.com",
    "ticker": "string",
    "is_listed": true
}
Modified at 2025-05-24 05:59:30
Previous
List Companies
Next
List Filings
Built with