Skip to content

Get financial statements

Look up standardized or as-reported line items on a company’s income statements, balance sheets and cash flow statements.

How it works

  • Compare periods. The default standardized view returns financials. Choose annual, quarterly, half-year, trailing twelve months or reported durations. Match rows by date and currency, and check the start dates when comparing flows.
  • Read the currency on each row. Flows use period-average exchange rates and balances use closing rates. When you request a currency, fields without the required rate are null.
  • Reconstruct what was known. Set known_by to use evidence available by that date. For standardized rows, use available_on for an exact availability date or available_on_gte and available_on_lte for an inclusive window. Availability can be later than the original filing_date.
  • Check a figure against the filing. Add include_sources=true to the request, or pass "include_sources": true to get_financials. Open a link in source_documents to read the original figures in the reporting currency. A fourth quarter can use both the annual and nine-month filings. Each document has its own filing date, and the row’s filing_date is the latest known date among them. A missing link or date is null.
  • Page by reporting date. Each page includes all three collections for the selected end dates. Use next_offset to continue.
  • Compare line items year over year. Set include_growth=true for changes against the comparable year-earlier statement. Changes use original reporting units, even if you request converted statements. Missing or incompatible inputs omit the line. Percentage growth is a decimal and is null for a non-positive prior value or a negative current value.
  • Read a filing's statement layout. Set view=as_reported for reports with the available structured statement rows. Rows follow the filing's presentation taxonomy and depth indicates nesting, starting at zero. Monetary values are in unscaled reporting-currency units, EPS is in currency per share, and share counts are in shares. Values retain presentation signs and dates. A balance has a null start date, and interim cash flows can cover the year to date. Headings and conflicting figures can have a null value.
  • Select an as-reported filing. Choose annual, quarterly, interim (including quarterly), or all annual and interim filings. Pass a document_id returned with source information for that company to select an exact filing in place of the period filter. from and to filter report dates. Use filing_date or filing_date_gte and filing_date_lte for known publication dates. With include_sources=true, each report includes its filing identifier and a direct link when available. Pages count filings, including those with null statements. Coverage requires structured statement presentation and varies by market and filing. Fund share classes can return an empty report list.

Request

GET /api/v1/financials with your API key. AI assistants call it as the get_financials tool, with the same parameters.

Parameters

qstringrequired

Ticker with its exchange code or MIC (AAPL:US, AAPL:XNAS, TSCO:XLON), ISIN, CUSIP, SEDOL, WKN, FIGI, LEI, CIK or company registration number. Any ticker and mic a listing returns work as ticker:mic.

More parameters

include_sourcesboolean

Include available source documents and supporting evidence. Omit for data only.

Default: false

viewstring

Statement view. Defaults to standardized.

One of: standardized, as_reported

periodstring

Annual or quarterly in either view. Standardized also supports half_year, ttm and reported. As-reported also supports interim and all.

Default: annual · One of: annual, quarterly, half_year, ttm, reported, interim, all

document_idstring

As-reported only. Select this filing regardless of period.

currencystring

Standardized only. Currency to convert amounts and EPS to, such as USD. Defaults to the reporting currency.

fromdate

Only periods ending on or after this date.

YYYY-MM-DD

todate

Only periods ending on or before this date.

YYYY-MM-DD

known_bydate

Use evidence available on or before this date.

YYYY-MM-DD

include_growthboolean

Standardized only. Include year-over-year line-item changes in original reporting units.

available_ondate

Standardized only. Evidence available on this date.

YYYY-MM-DD

available_on_gtedate

Standardized only. Evidence available on or after this date.

YYYY-MM-DD

available_on_gtdate

Standardized only. Evidence available after this date.

YYYY-MM-DD

available_on_ltedate

Standardized only. Evidence available on or before this date.

YYYY-MM-DD

available_on_ltdate

Standardized only. Evidence available before this date.

YYYY-MM-DD

filing_datedate

As-reported only. Published on this date.

YYYY-MM-DD

filing_date_gtedate

As-reported only. Published on or after this date.

YYYY-MM-DD

filing_date_gtdate

As-reported only. Published after this date.

YYYY-MM-DD

filing_date_ltedate

As-reported only. Published on or before this date.

YYYY-MM-DD

filing_date_ltdate

As-reported only. Published before this date.

YYYY-MM-DD

limitinteger

Maximum reporting end dates in standardized view or filings in as-reported view.

Default: 5 · From 1 to 100

offsetinteger

Reporting end dates or filings to skip, depending on the view.

Default: 0 · From 0 to 9007199254740991

Response

JSON with these fields. A field the source doesn't report is null or left out.

query

Requested identifier

next_offset

Offset for the next page, or null

financialsobjectrequired
Show child attributes
income_statementsarray of objectsrequired
Show child attributes
available_on

Latest known availability date of the evidence used for this row

year_over_yearobject
Show child attributes
prior_end_date

End or measurement date of the comparable year-earlier statement

prior_available_on

Latest known availability date of the prior statement evidence

currency

Original reporting currency for monetary changes

line_itemsarray of objects
Show child attributes
field

Standardized line-item name

change

Current amount minus prior amount in original units

growth

Change divided by prior amount. Null for a non-positive prior value or negative current value

filing_date

With include_sources=true, latest known filing date among the documents supporting this row

source_documentsarray of objects
Show child attributes
document_id

Filing directory key when available

source_document_id

Original source identifier, such as an SEC accession

filing_date

Date this document was filed

url

Link to the source document when available

period

Reporting period type

fiscal_year

Fiscal year

fiscal_period

Fiscal period label

reporting_currency

Original statement currency

currency

Currency of returned amounts

start_date

Period start

end_date

Period end

currency_conversionobject
Show child attributes
from

Original currency

rate

Conversion multiplier

method

Conversion method

rate_start_date

First rate date

rate_end_date

Last rate date

revenue

revenue. Reported value; null if unavailable.

cost_of_revenue

Reported cost of goods and services sold. Other separately presented charges, including insurance and reinsurance expenses, can also affect gross profit.

gross_profit

Reported gross profit. Derived as revenue less non-negative cost of revenue only when both are available and no insurance activity is reported.

operating_expenses

Reported operating expenses excluding the separately presented cost of revenue. Null when that subtotal is not reported.

total_operating_expenses

Reported total operating expenses, which may include cost of revenue.

selling_general_and_administrative_expenses

selling general and administrative expenses. Reported value; null if unavailable.

administrative_expenses

Reported administrative expenses.

distribution_costs

Reported distribution costs.

research_and_development

research and development. Reported value; null if unavailable.

operating_income

operating income. Reported value; null if unavailable.

interest_expense

Reported total interest expense for the period; broader finance costs and debt-only components are not substituted.

pretax_income

Reported profit or loss before income tax.

income_tax_expense

income tax expense. Reported value; null if unavailable.

net_income

Profit or loss attributable to shareholders of the parent company: the figure EPS is based on, and what US GAAP calls net income.

net_income_including_non_controlling_interests

Consolidated profit or loss, including non-controlling interests. For a US GAAP filing that reports neither consolidated profit nor a non-controlling share for the period (ASC 810 requires both when a non-controlling interest exists), it equals profit attributable to the parent; otherwise it is never substituted with that figure.

net_income_from_discontinued_operations

Reported profit or loss from discontinued operations.

preferred_dividends_impact

Reported preferred-stock dividend and related income-statement adjustments that reduce profit available to common shareholders when positive.

net_income_available_to_common_shareholders

Reported profit available to common shareholders, or parent profit less the preferred-dividend impact when both inputs belong to the same filing and period. Missing adjustments are not zero.

earnings_per_share

Reported basic earnings per ordinary share in currency; not adjusted for depositary-receipt ratios. Never derived by adding quarterly EPS.

earnings_per_share_diluted

Reported diluted earnings per ordinary share in currency; not adjusted for depositary-receipt ratios.

weighted_average_shares

Reported weighted-average ordinary shares, not an end-of-period share count. Unaffected by currency conversion.

weighted_average_shares_diluted

Reported diluted weighted-average ordinary shares. Unaffected by currency conversion.

ebit

Earnings before interest and tax, defined here as pretax income plus total interest expense for the same period and filing. Interest income remains included in pretax income. Broad finance costs, partial debt-interest amounts and operating income are not substituted. Null when compatible inputs are unavailable.

ebitda

EBIT plus cash-flow depreciation and amortization for the same period and reporting currency. Null when either input is unavailable.

balance_sheetsarray of objectsrequired
Show child attributes
available_on

Latest known availability date of the evidence used for this row

year_over_yearobject
Show child attributes
prior_end_date

End or measurement date of the comparable year-earlier statement

prior_available_on

Latest known availability date of the prior statement evidence

currency

Original reporting currency for monetary changes

line_itemsarray of objects
Show child attributes
field

Standardized line-item name

change

Current amount minus prior amount in original units

growth

Change divided by prior amount. Null for a non-positive prior value or negative current value

filing_date

With include_sources=true, latest known filing date among the documents supporting this row

source_documentsarray of objects
Show child attributes
document_id

Filing directory key when available

source_document_id

Original source identifier, such as an SEC accession

filing_date

Date this document was filed

url

Link to the source document when available

period

Reporting period type

fiscal_year

Fiscal year

fiscal_period

Fiscal period label

reporting_currency

Original statement currency

currency

Currency of returned amounts

currency_conversionobject
Show child attributes
from

Original currency

rate

Conversion multiplier

method

Conversion method

rate_date

Closing rate date

as_of

Date at which these balances were measured.

total_assets

All recognized assets at the reporting date.

current_assets

Assets classified as current by the company.

non_current_assets

Assets classified as non-current; includes fixed assets under UK reporting. May be calculated as total assets less current assets when both are known.

cash_and_equivalents

Cash and cash equivalents, excluding separately classified restricted cash.

inventory

Net carrying value of inventories.

current_investments

Reported short-term investments or current marketable securities; not all current financial assets.

trade_receivables

Current trade receivables, net of allowances.

property_plant_and_equipment

Net carrying value of property, plant and equipment.

goodwill

Recognized goodwill, net of impairment.

intangible_assets_excluding_goodwill

Net intangible assets excluding goodwill. A finite-lived-only component is not substituted.

total_liabilities

Total liabilities; may be calculated from both reported current and non-current liabilities.

current_liabilities

Liabilities classified as current by the company.

non_current_liabilities

Liabilities classified as non-current by the company. May be calculated as total liabilities less current liabilities when both are known.

current_debt

Reported current debt, or compatible short-term borrowings plus current long-term maturities. Commercial paper plus maturities is used only when those amounts and the other current-liability categories reconcile exactly to current liabilities.

non_current_debt

Reported non-current debt or borrowings. Treatment of leases follows the reported concept.

total_debt

Reported debt total or the sum of known current and non-current debt. Missing components are not zero; this is not a harmonized lease-adjusted measure.

trade_payables

Current trade accounts payable.

total_equity

Permanent equity including non-controlling interests. Reported or calculated from both known components. Parent equity is accepted alone only when it closes the reported combined liabilities/equity equation exactly and no nonzero temporary or non-controlling equity is reported.

equity_attributable_to_parent

Equity attributable to the parent shareholders, excluding non-controlling interests.

non_controlling_interests

Non-controlling interests classified within equity; excludes temporary or redeemable interests outside equity. May be calculated as total equity less parent equity when both are known.

retained_earnings

Accumulated retained earnings or deficit.

liabilities_and_equity

Reported combined liabilities and equity.

outstanding_shares

Reported shares outstanding at this exact balance-sheet date. Later cover-page share counts are excluded. Not affected by currency conversion.

cash_flow_statementsarray of objectsrequired
Show child attributes
available_on

Latest known availability date of the evidence used for this row

year_over_yearobject
Show child attributes
prior_end_date

End or measurement date of the comparable year-earlier statement

prior_available_on

Latest known availability date of the prior statement evidence

currency

Original reporting currency for monetary changes

line_itemsarray of objects
Show child attributes
field

Standardized line-item name

change

Current amount minus prior amount in original units

growth

Change divided by prior amount. Null for a non-positive prior value or negative current value

filing_date

With include_sources=true, latest known filing date among the documents supporting this row

source_documentsarray of objects
Show child attributes
document_id

Filing directory key when available

source_document_id

Original source identifier, such as an SEC accession

filing_date

Date this document was filed

url

Link to the source document when available

period

Reporting period type

fiscal_year

Fiscal year

fiscal_period

Fiscal period label

reporting_currency

Original statement currency

currency

Currency of returned amounts

start_date

Period start

end_date

Period end

currency_conversionobject
Show child attributes
from

Original currency

rate

Conversion multiplier

method

Conversion method

rate_start_date

First rate date

rate_end_date

Last rate date

beginning_cashobject
Show child attributes
rate

Closing exchange rate

as_of

Rate date

ending_cashobject
Show child attributes
rate

Closing exchange rate

as_of

Rate date

cash_balance_basis

Shared cash definition of the beginning and ending balances; null when it cannot be established.

beginning_cash_balance

Cash balance on the day before start_date, using the same cash definition as ending_cash_balance.

ending_cash_balance

Cash balance at end_date. It is never summed across quarters.

net_income_including_non_controlling_interests

Reported consolidated profit or loss for the period. For a US GAAP filing that tags neither consolidated profit nor a non-controlling share (ASC 810 requires both when a non-controlling interest exists), the reported parent profit.

depreciation_and_amortization

Reported depreciation and amortization adjustment; broader impairment totals are not substituted.

share_based_compensation

Share-based compensation adjustment.

net_cash_flow_from_operations

Net cash generated by or used in operating activities, including discontinued operations where reported in the total.

capital_expenditure

Negative cash payments to acquire property, plant and equipment. Broader purchases including intangibles are not substituted.

free_cash_flow

Operating cash flow plus negative capital expenditure. This definition excludes acquisitions and other investment spending.

business_acquisitions

Negative acquisition cash flow, net of cash acquired.

business_disposals

Cash received from business disposals, net of cash disposed.

net_cash_flow_from_investing

Net cash generated by or used in investing activities.

debt_issued

Reported debt-issuance proceeds, which may cover long-term debt only.

debt_repaid

Negative reported debt repayments, which may cover long-term debt only.

equity_issued

Share issuance proceeds. Option-exercise proceeds alone are not substituted.

equity_repurchased

Negative payments to repurchase shares.

dividends_and_other_cash_distributions

Negative reported dividend/distribution payments. A common-share-only amount is not substituted for the total.

net_cash_flow_from_financing

Net cash generated by or used in financing activities.

change_in_cash_and_equivalents

Reported cash change including currency effects. The cash_balance_basis identifies whether restricted cash is included when boundary balances are established.

effect_of_exchange_rate_changes

Reported currency effects on cash, under the reporting framework.

currency_translation_effect

Analytical adjustment caused by translating flows at an average rate and cash balances at closing rates. Populated only for converted rows whose original beginning balance plus cash change exactly equals ending balance. It is not an additional reported cash flow.

reportsarray of objectsrequired
Show child attributes
document_id

With include_sources=true, the identifier of the filing

filing_url

With include_sources=true, the direct URL of the filing, or null when unavailable

report_date

Date covered by the filing

period

Report frequency, when known

currency

Reporting currency, when known

income_statementobjectrequired
Show child attributes
line_itemsarray of objectsrequired
Show child attributes
label

Presentation label

full_label

Full label when available

value

Amount in its stated unit, or null for headings or unavailable values

unit

Currency code, currency per share (such as USD/shares), shares, ratio, or null

start_date

First day of the row's period, or null for a balance

end_date

Last day of the period or date of the balance

depth

Nesting level in the statement, starting at zero

balance_sheetobjectrequired
Show child attributes
line_itemsarray of objectsrequired
Show child attributes
label

Presentation label

full_label

Full label when available

value

Amount in its stated unit, or null for headings or unavailable values

unit

Currency code, currency per share (such as USD/shares), shares, ratio, or null

start_date

First day of the row's period, or null for a balance

end_date

Last day of the period or date of the balance

depth

Nesting level in the statement, starting at zero

cash_flow_statementobjectrequired
Show child attributes
line_itemsarray of objectsrequired
Show child attributes
label

Presentation label

full_label

Full label when available

value

Amount in its stated unit, or null for headings or unavailable values

unit

Currency code, currency per share (such as USD/shares), shares, ratio, or null

start_date

First day of the row's period, or null for a balance

end_date

Last day of the period or date of the balance

depth

Nesting level in the statement, starting at zero

match

Identifier lookup outcome. A found match can still have an empty page.

Errors

Status Meaning
400 Missing, unknown or invalid parameter, or an identifier that can't be looked up
401 Missing, unknown or revoked API key
402 No active plan or trial, or the included request allowance is used
403 API access of the account is suspended
404 The identifier matches nothing or is ambiguous. The match field identifies the outcome
429 Over the plan's rate limit; Retry-After says when to retry
500 Internal error; the same request is unlikely to succeed on retry
503 The data couldn't be loaded right now; Retry-After says when to retry, when known

Errors are JSON with an error message saying what to fix. Errors are free. See Errors and limits.

Esc

Documentation

Make your first request API keys and authentication Errors and limits Connect an AI assistant (MCP) Usage and billing Contact support Get company profile Get securities and listings Get reported earnings Get financial statements Get historical financial metrics Get financial segments Get historical shares outstanding Get fund holdings Find funds holding a security Screen companies Get screener filters
↑↓ to move to open