Company Endpoints
The Company Endpoints provide access to comprehensive company information including profiles, executive compensation, company notes, employee data, shares float information, and earnings call transcripts.
Available Methods
| Method | Endpoint | Description |
|---|---|---|
| GET | stable/profile?symbol={symbol} | Get comprehensive company profile information |
| GET | stable/governance-executive-compensation?symbol={symbol} | Get executive compensation data |
| GET | stable/company-notes?symbol={symbol} | Get company notes and financial statements |
| GET | stable/historical-employee-count?symbol={symbol} | Get historical employee count data |
| GET | stable/shares-float?symbol={symbol} | Get current shares float information |
| GET | v4/historical/shares_float?symbol={symbol} | Get historical shares float data |
| GET | v3/earning_call_transcript/{symbol} | Get earnings call transcripts |
| GET | v3/earning_call_transcript/{symbol} | Get company transcript dates and data |
| GET | stable/stock-peers?symbol={symbol} | Get peer companies with price and market cap |
Get Company Profile
Retrieve comprehensive company profile information including financial metrics, company details, and market data.
| Parameter | Type | Description | |
|---|---|---|---|
| symbol | string | required | Stock symbol (e.g., "AAPL", "MSFT") |
Example Response
Get Executive Compensation
Retrieve detailed executive compensation data including salary, bonuses, stock awards, and total compensation.
| Parameter | Type | Description | |
|---|---|---|---|
| symbol | string | required | Stock symbol |
Example Response
Get Company Notes
Retrieve company notes and financial statement information.
| Parameter | Type | Description | |
|---|---|---|---|
| symbol | string | required | Stock symbol |
Example Response
Get Historical Employee Count
Retrieve historical employee count data over time.
| Parameter | Type | Description | |
|---|---|---|---|
| symbol | string | required | Stock symbol |
Example Response
Get Shares Float
Retrieve current shares float information including free float, float shares, and outstanding shares.
| Parameter | Type | Description | |
|---|---|---|---|
| symbol | string | required | Stock symbol |
Example Response
Get Historical Shares Float
Retrieve historical shares float data over time.
| Parameter | Type | Description | |
|---|---|---|---|
| symbol | string | required | Stock symbol |
Example Response
Get Earnings Call Transcript
Retrieve earnings call transcripts for specific quarters and years.
| Parameter | Type | Description | |
|---|---|---|---|
| symbol | string | required | Stock symbol |
| year | number | required | Year of the earnings call |
| quarter | number | required | Quarter of the earnings call (1-4) |
Example Response
Get Company Transcript Data
Retrieve available transcript dates and data for a company's earnings calls.
| Parameter | Type | Description | |
|---|---|---|---|
| symbol | string | required | Stock symbol |
Example Response
Get Stock Peers
Retrieve a list of peer companies for a stock, each with its current price and market cap. Useful for relative valuation and "compare X to its peers" analysis.
| Parameter | Type | Description | |
|---|---|---|---|
| symbol | string | required | Stock symbol |
Example Response
Data Types
CompanyProfile
ExecutiveCompensation
SharesFloat
HistoricalSharesFloat
CompanyTranscriptData
StockPeer
Note: The CompanyTranscriptData type represents an array where:
[0]: Year (number)[1]: Quarter (number, 1-4)[2]: Date (string, ISO format)
Error Handling
All company endpoints return a standardized response format with error handling:
When an error occurs, the response will include:
success: falsedata: nullerror: string- Description of the error
Rate Limits
Company endpoints are subject to the same rate limits as other FMP API endpoints. Please refer to your subscription plan for specific limits.