This endpoint replaces Financials.
Income Statements
GET
/stocks/financials/v1/income-statements
Retrieve comprehensive income statement data for public companies, including key metrics such as revenue, expenses, and net income for various reporting periods. This dataset provides detailed financial performance data including revenue breakdowns, operating expenses, and profitability metrics across quarterly, annual, and trailing twelve-month periods.
Use Cases: Profitability analysis, revenue trend analysis, expense management evaluation, earnings assessment.
Plan Accessloading..
Plan
Recency
Not included
Not included
Not included
End-of-day
End-of-day
End-of-day
End-of-day
Plan Recencyloading..
Plan
History
Not included
Not included
Not included
All history
All history
All history
All history
Plan Historyloading..
Query Parameters
cik
string
The company's Central Index Key (CIK), a unique identifier assigned by the U.S. Securities and Exchange Commission (SEC). You can look up a company’s CIK using the SEC CIK Lookup tool.
tickers
string
Filter for arrays that contain the value.
period_end
string
The last date of the reporting period (formatted as YYYY-MM-DD). Value must be formatted 'yyyy-mm-dd'.
filing_date
string
The date when the financial statement was filed with the SEC. Value must be formatted 'yyyy-mm-dd'.
fiscal_year
number
The fiscal year for the reporting period. Value must be a floating point number.
fiscal_quarter
number
The fiscal quarter number (1, 2, 3, or 4) for the reporting period. Value must be a floating point number.
timeframe
string
The reporting period type. Possible values include: quarterly, annual, trailing_twelve_months.
limit
integer
Limit the maximum number of results returned. Defaults to '100' if not specified. The maximum allowed limit is '50000'.
sort
string
A comma separated list of sort columns. For each column, append '.asc' or '.desc' to specify the sort direction. The sort column defaults to 'period_end' if not specified. The sort order defaults to 'asc' if not specified.
Response Attributes
next_url
string
optional
If present, this value can be used to fetch the next page.
request_id
string
A request id assigned by the server.
results
array (object)
The results for this request.
basic_earnings_per_share
number
optional
Earnings per share calculated using the weighted average number of basic shares outstanding. For TTM records, recalculated as TTM net income divided by average basic shares outstanding over the four quarters.
basic_shares_outstanding
number
optional
Weighted average number of common shares outstanding during the period, used in basic EPS calculation. For TTM records, represents the average over the four most recent quarters.
cik
string
optional
The company's Central Index Key (CIK), a unique identifier assigned by the U.S. Securities and Exchange Commission (SEC). You can look up a company’s CIK using the SEC CIK Lookup tool.
consolidated_net_income_loss
number
optional
Total net income or loss for the consolidated entity including all subsidiaries.
cost_of_revenue
number
optional
Direct costs attributable to the production of goods or services sold, also known as cost of goods sold (COGS).
depreciation_depletion_amortization
number
optional
Non-cash expenses representing the allocation of asset costs over their useful lives.
diluted_earnings_per_share
number
optional
Earnings per share calculated using diluted shares outstanding, including the effect of potentially dilutive securities. For TTM records, recalculated as TTM net income divided by average diluted shares outstanding over the four quarters.
diluted_shares_outstanding
number
optional
Weighted average number of shares outstanding including the dilutive effect of stock options, warrants, and convertible securities. For TTM records, represents the average over the four most recent quarters.
discontinued_operations
number
optional
After-tax results from business segments that have been or will be disposed of.
ebitda
number
optional
Earnings before interest, taxes, depreciation, and amortization, a measure of operating performance.
equity_in_affiliates
number
optional
The company's share of income or losses from equity method investments in affiliated companies.
extraordinary_items
number
optional
Unusual and infrequent gains or losses that are both unusual in nature and infrequent in occurrence.
filing_date
string
optional
The date when the financial statement was filed with the SEC.
fiscal_quarter
number
optional
The fiscal quarter number (1, 2, 3, or 4) for the reporting period.
fiscal_year
number
optional
The fiscal year for the reporting period.
gross_profit
number
optional
Revenue minus cost of revenue, representing profit before operating expenses.
income_before_income_taxes
number
optional
Pre-tax income calculated as operating income plus total other income/expense.
income_taxes
number
optional
Income tax expense or benefit for the period.
interest_expense
number
optional
Cost of borrowed funds, including interest on debt and other financing obligations.
interest_income
number
optional
Income earned from interest-bearing investments and cash equivalents.
net_income_loss_attributable_common_shareholders
number
optional
Net income or loss available to common shareholders after preferred dividends and noncontrolling interests.
noncontrolling_interest
number
optional
The portion of net income attributable to minority shareholders in consolidated subsidiaries.
operating_income
number
optional
Income from operations calculated as gross profit minus total operating expenses, excluding non-operating items.
other_income_expense
number
optional
Non-operating income and expenses not related to the company's core business operations.
other_operating_expenses
number
optional
Operating expenses not classified in the main expense categories.
period_end
string
optional
The last date of the reporting period (formatted as YYYY-MM-DD).
preferred_stock_dividends_declared
number
optional
Dividends declared on preferred stock during the period.
research_development
number
optional
Expenses incurred for research and development activities to create new products or improve existing ones.
revenue
number
optional
Total revenue or net sales for the period, representing the company's gross income from operations.
selling_general_administrative
number
optional
Expenses related to selling products and general administrative costs not directly tied to production.
tickers
array (string)
optional
A list of ticker symbols under which the company is listed. Multiple symbols may indicate different share classes for the same company.
timeframe
string
optional
The reporting period type. Possible values include: quarterly, annual, trailing_twelve_months.
total_operating_expenses
number
optional
Sum of all operating expenses including cost of revenue, SG&A, R&D, depreciation, and other operating expenses.
total_other_income_expense
number
optional
Net total of all non-operating income and expenses including interest income, interest expense, and other items.
status
enum (OK)
The status of this request's response.
Code Examples
Query URL
GET
loading...Run query unavailable
Create account or sign in to Polygon
Scroll to see updated query response
Response Object