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
standardizedview returnsfinancials. 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_byto use evidence available by that date. For standardized rows, useavailable_onfor an exact availability date oravailable_on_gteandavailable_on_ltefor an inclusive window. Availability can be later than the originalfiling_date. -
Check a figure against the filing. Add
include_sources=trueto the request, or pass"include_sources": truetoget_financials. Open a link insource_documentsto 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’sfiling_dateis 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_offsetto continue. -
Compare line items year over year. Set
include_growth=truefor 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_reportedforreportswith the available structured statement rows. Rows follow the filing's presentation taxonomy anddepthindicates 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_idreturned with source information for that company to select an exact filing in place of the period filter.fromandtofilter report dates. Usefiling_dateorfiling_date_gteandfiling_date_ltefor known publication dates. Withinclude_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.
queryRequested identifier
next_offsetOffset for the next page, or null
financialsobjectrequired
Show child attributes
income_statementsarray of objectsrequired
Show child attributes
available_onLatest known availability date of the evidence used for this row
year_over_yearobject
Show child attributes
prior_end_dateEnd or measurement date of the comparable year-earlier statement
prior_available_onLatest known availability date of the prior statement evidence
currencyOriginal reporting currency for monetary changes
line_itemsarray of objects
Show child attributes
fieldStandardized line-item name
changeCurrent amount minus prior amount in original units
growthChange divided by prior amount. Null for a non-positive prior value or negative current value
filing_dateWith include_sources=true, latest known filing date among the documents supporting this row
source_documentsarray of objects
Show child attributes
document_idFiling directory key when available
source_document_idOriginal source identifier, such as an SEC accession
filing_dateDate this document was filed
urlLink to the source document when available
periodReporting period type
fiscal_yearFiscal year
fiscal_periodFiscal period label
reporting_currencyOriginal statement currency
currencyCurrency of returned amounts
start_datePeriod start
end_datePeriod end
currency_conversionobject
Show child attributes
fromOriginal currency
rateConversion multiplier
methodConversion method
rate_start_dateFirst rate date
rate_end_dateLast rate date
revenuerevenue. Reported value; null if unavailable.
cost_of_revenueReported cost of goods and services sold. Other separately presented charges, including insurance and reinsurance expenses, can also affect gross profit.
gross_profitReported gross profit. Derived as revenue less non-negative cost of revenue only when both are available and no insurance activity is reported.
operating_expensesReported operating expenses excluding the separately presented cost of revenue. Null when that subtotal is not reported.
total_operating_expensesReported total operating expenses, which may include cost of revenue.
selling_general_and_administrative_expensesselling general and administrative expenses. Reported value; null if unavailable.
administrative_expensesReported administrative expenses.
distribution_costsReported distribution costs.
research_and_developmentresearch and development. Reported value; null if unavailable.
operating_incomeoperating income. Reported value; null if unavailable.
interest_expenseReported total interest expense for the period; broader finance costs and debt-only components are not substituted.
pretax_incomeReported profit or loss before income tax.
income_tax_expenseincome tax expense. Reported value; null if unavailable.
net_incomeProfit 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_interestsConsolidated 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_operationsReported profit or loss from discontinued operations.
preferred_dividends_impactReported preferred-stock dividend and related income-statement adjustments that reduce profit available to common shareholders when positive.
net_income_available_to_common_shareholdersReported 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_shareReported basic earnings per ordinary share in currency; not adjusted for depositary-receipt ratios. Never derived by adding quarterly EPS.
earnings_per_share_dilutedReported diluted earnings per ordinary share in currency; not adjusted for depositary-receipt ratios.
weighted_average_sharesReported weighted-average ordinary shares, not an end-of-period share count. Unaffected by currency conversion.
weighted_average_shares_dilutedReported diluted weighted-average ordinary shares. Unaffected by currency conversion.
ebitEarnings 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.
ebitdaEBIT 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_onLatest known availability date of the evidence used for this row
year_over_yearobject
Show child attributes
prior_end_dateEnd or measurement date of the comparable year-earlier statement
prior_available_onLatest known availability date of the prior statement evidence
currencyOriginal reporting currency for monetary changes
line_itemsarray of objects
Show child attributes
fieldStandardized line-item name
changeCurrent amount minus prior amount in original units
growthChange divided by prior amount. Null for a non-positive prior value or negative current value
filing_dateWith include_sources=true, latest known filing date among the documents supporting this row
source_documentsarray of objects
Show child attributes
document_idFiling directory key when available
source_document_idOriginal source identifier, such as an SEC accession
filing_dateDate this document was filed
urlLink to the source document when available
periodReporting period type
fiscal_yearFiscal year
fiscal_periodFiscal period label
reporting_currencyOriginal statement currency
currencyCurrency of returned amounts
currency_conversionobject
Show child attributes
fromOriginal currency
rateConversion multiplier
methodConversion method
rate_dateClosing rate date
as_ofDate at which these balances were measured.
total_assetsAll recognized assets at the reporting date.
current_assetsAssets classified as current by the company.
non_current_assetsAssets 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_equivalentsCash and cash equivalents, excluding separately classified restricted cash.
inventoryNet carrying value of inventories.
current_investmentsReported short-term investments or current marketable securities; not all current financial assets.
trade_receivablesCurrent trade receivables, net of allowances.
property_plant_and_equipmentNet carrying value of property, plant and equipment.
goodwillRecognized goodwill, net of impairment.
intangible_assets_excluding_goodwillNet intangible assets excluding goodwill. A finite-lived-only component is not substituted.
total_liabilitiesTotal liabilities; may be calculated from both reported current and non-current liabilities.
current_liabilitiesLiabilities classified as current by the company.
non_current_liabilitiesLiabilities classified as non-current by the company. May be calculated as total liabilities less current liabilities when both are known.
current_debtReported 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_debtReported non-current debt or borrowings. Treatment of leases follows the reported concept.
total_debtReported 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_payablesCurrent trade accounts payable.
total_equityPermanent 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_parentEquity attributable to the parent shareholders, excluding non-controlling interests.
non_controlling_interestsNon-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_earningsAccumulated retained earnings or deficit.
liabilities_and_equityReported combined liabilities and equity.
outstanding_sharesReported 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_onLatest known availability date of the evidence used for this row
year_over_yearobject
Show child attributes
prior_end_dateEnd or measurement date of the comparable year-earlier statement
prior_available_onLatest known availability date of the prior statement evidence
currencyOriginal reporting currency for monetary changes
line_itemsarray of objects
Show child attributes
fieldStandardized line-item name
changeCurrent amount minus prior amount in original units
growthChange divided by prior amount. Null for a non-positive prior value or negative current value
filing_dateWith include_sources=true, latest known filing date among the documents supporting this row
source_documentsarray of objects
Show child attributes
document_idFiling directory key when available
source_document_idOriginal source identifier, such as an SEC accession
filing_dateDate this document was filed
urlLink to the source document when available
periodReporting period type
fiscal_yearFiscal year
fiscal_periodFiscal period label
reporting_currencyOriginal statement currency
currencyCurrency of returned amounts
start_datePeriod start
end_datePeriod end
currency_conversionobject
Show child attributes
fromOriginal currency
rateConversion multiplier
methodConversion method
rate_start_dateFirst rate date
rate_end_dateLast rate date
beginning_cashobject
Show child attributes
rateClosing exchange rate
as_ofRate date
ending_cashobject
Show child attributes
rateClosing exchange rate
as_ofRate date
cash_balance_basisShared cash definition of the beginning and ending balances; null when it cannot be established.
beginning_cash_balanceCash balance on the day before start_date, using the same cash definition as ending_cash_balance.
ending_cash_balanceCash balance at end_date. It is never summed across quarters.
net_income_including_non_controlling_interestsReported 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_amortizationReported depreciation and amortization adjustment; broader impairment totals are not substituted.
share_based_compensationShare-based compensation adjustment.
net_cash_flow_from_operationsNet cash generated by or used in operating activities, including discontinued operations where reported in the total.
capital_expenditureNegative cash payments to acquire property, plant and equipment. Broader purchases including intangibles are not substituted.
free_cash_flowOperating cash flow plus negative capital expenditure. This definition excludes acquisitions and other investment spending.
business_acquisitionsNegative acquisition cash flow, net of cash acquired.
business_disposalsCash received from business disposals, net of cash disposed.
net_cash_flow_from_investingNet cash generated by or used in investing activities.
debt_issuedReported debt-issuance proceeds, which may cover long-term debt only.
debt_repaidNegative reported debt repayments, which may cover long-term debt only.
equity_issuedShare issuance proceeds. Option-exercise proceeds alone are not substituted.
equity_repurchasedNegative payments to repurchase shares.
dividends_and_other_cash_distributionsNegative reported dividend/distribution payments. A common-share-only amount is not substituted for the total.
net_cash_flow_from_financingNet cash generated by or used in financing activities.
change_in_cash_and_equivalentsReported cash change including currency effects. The cash_balance_basis identifies whether restricted cash is included when boundary balances are established.
effect_of_exchange_rate_changesReported currency effects on cash, under the reporting framework.
currency_translation_effectAnalytical 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_idWith include_sources=true, the identifier of the filing
filing_urlWith include_sources=true, the direct URL of the filing, or null when unavailable
report_dateDate covered by the filing
periodReport frequency, when known
currencyReporting currency, when known
income_statementobjectrequired
Show child attributes
line_itemsarray of objectsrequired
Show child attributes
labelPresentation label
full_labelFull label when available
valueAmount in its stated unit, or null for headings or unavailable values
unitCurrency code, currency per share (such as USD/shares), shares, ratio, or null
start_dateFirst day of the row's period, or null for a balance
end_dateLast day of the period or date of the balance
depthNesting level in the statement, starting at zero
balance_sheetobjectrequired
Show child attributes
line_itemsarray of objectsrequired
Show child attributes
labelPresentation label
full_labelFull label when available
valueAmount in its stated unit, or null for headings or unavailable values
unitCurrency code, currency per share (such as USD/shares), shares, ratio, or null
start_dateFirst day of the row's period, or null for a balance
end_dateLast day of the period or date of the balance
depthNesting level in the statement, starting at zero
cash_flow_statementobjectrequired
Show child attributes
line_itemsarray of objectsrequired
Show child attributes
labelPresentation label
full_labelFull label when available
valueAmount in its stated unit, or null for headings or unavailable values
unitCurrency code, currency per share (such as USD/shares), shares, ratio, or null
start_dateFirst day of the row's period, or null for a balance
end_dateLast day of the period or date of the balance
depthNesting level in the statement, starting at zero
matchIdentifier 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.