Retrieve a company profile

Return the primary-listing profile for a public company. The resource combines business identity, classification, contact details, reporting dates, and external identifiers. Its company_symbols array lists every exchange listing for the company, with the primary listing first.

GET/v3.0.0/company/profile/{identifier}

Plan Access

Free

(Your plan)

Individual

$29/mo

Professional

$89/mo

Request
curl "https://api.roic.ai/v3.0.0/company/profile/NASDAQ:AAPL?apikey=YOUR_API_KEY"
Response
200 OK
{
  "id": "cmp_mN971Tvggqaf82",
  "object": "v3.reference.company_profile",
  "primary_symbol": "NASDAQ:AAPL",
  "exchange": "NASDAQ",
  "mic": "XNGS",
  "exchange_name": "Nasdaq Stock Market",
  "exchange_local_name": "Nasdaq Stock Market",
  "name": "Apple Inc.",
  "description": "Apple, Inc. engages in the design, manufacture, and sale of smartphones, personal computers, tablets, wearables and accessories, and other varieties of related services. It operates through the following geographical segments: Americas, Europe, Greater China, Japan, and Rest of Asia Pacific. The Americas segment includes North and South America. The Europe segment consists of European countries, as well as India, the Middle East, and Africa. The Greater China segment comprises China, Hong Kong, and Taiwan. The Rest of Asia Pacific segment includes Australia and Asian countries. Its products and services include iPhone, Mac, iPad, AirPods, Apple TV, Apple Watch, Beats products, AppleCare, iCloud, digital content stores, streaming, and licensing services. The company was founded by Steven Paul Jobs, Ronald Gerald Wayne, and Stephen G. Wozniak in April 1976 and is headquartered in Cupertino, CA.",
  "short_description": "Apple Inc.",
  "sector": "Electronic technology",
  "industry": "Telecommunications equipment",
  "fundamental_currency": "USD",
  "cik": "0000320193",
  "cusip": "037833100",
  "isin": "US0378331005",
  "ceo": "Timothy Donald Cook",
  "founded": "1976",
  "website": "http://www.apple.com",
  "phone": "(408) 996-1010",
  "number_of_employees": 166000,
  "number_of_shareholders": 22429,
  "address": {
    "line1": "One Apple Park Way",
    "city": "Cupertino",
    "state": "CA",
    "postal_code": "95014",
    "country": "United States",
    "country_code": "US"
  },
  "ipo": {
    "date": "1980-12-12",
    "price_usd": null,
    "amount_raised_usd": null
  },
  "reporting_calendar": {
    "current_period": "2026-Q2",
    "current_period_end": "2026-03-31",
    "current_fiscal_year": "2025",
    "current_fiscal_year_end": "2025-09-30",
    "reports_per_year": 4
  },
  "earnings_schedule": {
    "last_release_date": "2026-04-30",
    "next_release_date": "2026-07-30",
    "last_release_time": "2026-04-30T20:30:00.000Z",
    "next_release_time": "2026-07-30T20:30:00.000Z"
  },
  "company_symbols": [
    "NASDAQ:AAPL",
    "B3:AAPL34",
    "BCS:AAPL",
    "BCS:AAPLCL",
    "BCS:AAPLCL1",
    "BIVA:AAPL",
    "BMV:AAPL",
    "BSEBG:APC",
    "BVC:AAPL",
    "BVL:AAPLUS",
    "BX:APC",
    "BYMA:AAPL",
    "BYMA:AAPL.CI",
    "BYMA:AAPLC",
    "BYMA:AAPLD",
    "DUS:APC",
    "EUROTLX:4AAPL",
    "FRA:APC",
    "GETTEX:APC",
    "GPW:AAPL",
    "HAM:APC",
    "HAN:APC",
    "MIL:1AAPL",
    "MUN:APC",
    "NEO:AAPL",
    "NEO:ZAAP",
    "SET:AAPL01",
    "SET:AAPL03",
    "SET:AAPL19",
    "SET:AAPL80",
    "SIX:AAPL",
    "SIX:AAPL.USD",
    "STU:APC",
    "TG:APC",
    "TSX:AAPL",
    "VIE:AAPL",
    "XETR:APC"
  ]
}

Parameters

Path parameters

identifierstringrequired

A company-profile ID (cmp_…), ticker ID (tkr_…), an exchange and symbol separated by a colon (e.g. NASDAQ:AAPL), or a FIGI.

Examples: NASDAQ:AAPLcmp_mN971Tvggqaf82BBG000B9XRY4

Response

Response fields

idstring

Unique identifier for the company profile, beginning with cmp_. Store this ID as the stable reference to the company.

objectstring

String representing the object's type, always v3.reference.company_profile for this resource.

primary_symbolstring

Qualified symbol of the company's primary listing, combining the exchange code and ticker, e.g. NASDAQ:AAPL. A company profile always reports the primary listing, so the listing-specific fields (primary_symbol, exchange, mic, cik, cusip, isin) all describe that listing. Use company_symbols to reach the other listings.

exchangestring

Short code of the exchange of the primary listing, e.g. NASDAQ.

micstring

The ISO 10383 Market Identifier Code of the primary listing venue, e.g. XNGS for the Nasdaq Global Select Market.

exchange_namestring

Normalized English display name of the primary listing's exchange, e.g. Nasdaq Stock Market. null when the exchange is not yet in the reference map.

exchange_local_namestring

Local or venue-specific name associated with the primary listing's exchange and MIC. It may equal exchange_name; null when unavailable.

namestring

Registered name of the company, e.g. Apple Inc. Use it for display; it is not a stable identifier.

descriptionstring

Long-form English description of the company's business, products, and markets. Typically a paragraph of prose suitable for display.

short_descriptionstring

One-sentence summary of the business, useful for cards and list views.

sectorstring

Broad market sector the company belongs to, e.g. Technology. Values match the names returned by the List sectors endpoint.

industrystring

More specific industry classification within the sector, e.g. Consumer Electronics. Values match the names returned by the List industries endpoint.

fundamental_currencystring

ISO 4217 code of the currency the company reports its financial statements in.

cikstring

The SEC Central Index Key (CIK) of the primary listing, a zero-padded 10-digit string, e.g. 0000320193. null for companies that do not file with the SEC.

cusipstring

The CUSIP of the primary listing, a 9-character alphanumeric code that identifies North American securities. null when not available.

isinstring

The ISIN of the primary listing, a 12-character code that starts with a two-letter country code, e.g. US0378331005. null when not available.

ceostring

Full name of the current chief executive officer, e.g. Tim Cook.

foundedstring

Year the company was founded, as a string, e.g. 1976.

websitestring

URL of the company's official website, including the scheme, e.g. https://www.apple.com.

phonestring

Main phone number of the company's headquarters, including the country code.

number_of_employeesnumber

Number of employees as most recently reported by the company.

number_of_shareholdersnumber

Number of shareholders of record as reported in company filings. null when the company does not disclose it.

addressobject

Object holding the postal address of the company's headquarters.

+ Show child attributes
line1string

Street address line of the headquarters, e.g. One Apple Park Way.

citystring

City the headquarters is located in, e.g. Cupertino.

statestring

State, province, or region of the headquarters, e.g. California.

postal_codestring

Postal or ZIP code of the headquarters.

countrystring

Country of the headquarters, e.g. United States.

country_codestring

Two-letter ISO 3166-1 country code of the headquarters, e.g. US.

ipoobject

Object describing the company's initial public offering.

+ Show child attributes
datestring

Date of the initial public offering, in YYYY-MM-DD format.

price_usdnullable

Offering price per share at the IPO, in US dollars.

amount_raised_usdnullable

Total amount the company raised in the IPO, in US dollars.

reporting_calendarobject

Object describing where the company currently is in its financial reporting cycle.

+ Show child attributes
current_periodstring

Label of the reporting period the company is currently in, e.g. Q3.

current_period_endstring

End date of the current reporting period, in YYYY-MM-DD format.

current_fiscal_yearstring

Label of the current fiscal year, e.g. FY2026.

current_fiscal_year_endstring

End date of the current fiscal year, in YYYY-MM-DD format. Fiscal years may not align with calendar years.

reports_per_yearnumber

How many financial reports the company files per year: 4 for quarterly filers, 2 for semi-annual filers.

earnings_scheduleobject

Object holding the company's most recent and next scheduled earnings releases.

+ Show child attributes
last_release_datestring

Date of the most recent earnings release, in YYYY-MM-DD format.

next_release_datestring

Date of the next scheduled earnings release, in YYYY-MM-DD format. null when the company has not yet announced it.

last_release_timestring

Exact time of the most recent earnings release, as an ISO 8601 UTC timestamp.

next_release_timestring

Exact time of the next scheduled earnings release, as an ISO 8601 UTC timestamp. null when not yet announced.

company_symbolsarray of strings

Qualified symbols for every exchange listing of this company. The company's primary listing appears first, followed by the remaining symbols alphabetically. Use this array when you need to find or link to the same company on another exchange.

Nullable fields

Profile fields remain present when data is unavailable and use null instead of disappearing. This lets typed clients keep one stable response shape.

Primary listing

A company profile always reports data for the company's primary listing. The listing-specific fields (primary_symbol, exchange, mic, cik, cusip, and isin) therefore describe that listing, even when you resolve the profile through a secondary listing's identifier. exchange_name gives the normalized English display name, while exchange_local_name gives the local or venue-specific name associated with the primary listing's exchange and MIC.

Exchange listings

Use company_symbols to find the same company on another exchange without running a ticker search. Every value is exchange-qualified, such as NASDAQ:AAPL, so each listing is unambiguous.

Related endpoints

Use the ticker and logo resources alongside a company profile.