# 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 {#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 {#request} `GET /api/v1/financials` with your API key. AI assistants call it as the `get_financials` tool, with the same parameters. ``` curl "https://financialdb.ai/api/v1/financials?q=AAPL:US" \ -H "Authorization: Bearer $FDB_API_KEY" ``` ## Parameters {#parameters} | Parameter | Type | Description | |---|---|---| | `include_sources` | boolean | Include available source documents and supporting evidence. Omit for data only. Default: `false`. | | `q` (required) | string | 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. | | `view` | string: standardized, as_reported | Statement view. Defaults to standardized. | | `period` | string: annual, quarterly, half_year, ttm, reported, interim, all | Annual or quarterly in either view. Standardized also supports half_year, ttm and reported. As-reported also supports interim and all. Default: `annual`. | | `document_id` | string | As-reported only. Select this filing regardless of period. | | `currency` | string | Standardized only. Currency to convert amounts and EPS to, such as USD. Defaults to the reporting currency. | | `from` | date | Only periods ending on or after this date. | | `to` | date | Only periods ending on or before this date. | | `known_by` | date | Use evidence available on or before this date. | | `include_growth` | boolean | Standardized only. Include year-over-year line-item changes in original reporting units. | | `available_on` | date | Standardized only. Evidence available on this date. | | `available_on_gte` | date | Standardized only. Evidence available on or after this date. | | `available_on_gt` | date | Standardized only. Evidence available after this date. | | `available_on_lte` | date | Standardized only. Evidence available on or before this date. | | `available_on_lt` | date | Standardized only. Evidence available before this date. | | `filing_date` | date | As-reported only. Published on this date. | | `filing_date_gte` | date | As-reported only. Published on or after this date. | | `filing_date_gt` | date | As-reported only. Published after this date. | | `filing_date_lte` | date | As-reported only. Published on or before this date. | | `filing_date_lt` | date | As-reported only. Published before this date. | | `limit` | integer: 1–100 | Maximum reporting end dates in standardized view or filings in as-reported view. Default: `5`. | | `offset` | integer: 0–9007199254740991 | Reporting end dates or filings to skip, depending on the view. Default: `0`. | ## Response {#response} JSON with these fields. A field the source doesn't report is null or left out. | Field | Description | |---|---| | `query` | Requested identifier | | `next_offset` | Offset for the next page, or null | | `financials.income_statements[].available_on` | Latest known availability date of the evidence used for this row | | `financials.income_statements[].year_over_year.prior_end_date` | End or measurement date of the comparable year-earlier statement | | `financials.income_statements[].year_over_year.prior_available_on` | Latest known availability date of the prior statement evidence | | `financials.income_statements[].year_over_year.currency` | Original reporting currency for monetary changes | | `financials.income_statements[].year_over_year.line_items[].field` | Standardized line-item name | | `financials.income_statements[].year_over_year.line_items[].change` | Current amount minus prior amount in original units | | `financials.income_statements[].year_over_year.line_items[].growth` | Change divided by prior amount. Null for a non-positive prior value or negative current value | | `financials.income_statements[].filing_date` | With include_sources=true, latest known filing date among the documents supporting this row | | `financials.income_statements[].source_documents[].document_id` | Filing directory key when available | | `financials.income_statements[].source_documents[].source_document_id` | Original source identifier, such as an SEC accession | | `financials.income_statements[].source_documents[].filing_date` | Date this document was filed | | `financials.income_statements[].source_documents[].url` | Link to the source document when available | | `financials.income_statements[].period` | Reporting period type | | `financials.income_statements[].fiscal_year` | Fiscal year | | `financials.income_statements[].fiscal_period` | Fiscal period label | | `financials.income_statements[].reporting_currency` | Original statement currency | | `financials.income_statements[].currency` | Currency of returned amounts | | `financials.income_statements[].start_date` | Period start | | `financials.income_statements[].end_date` | Period end | | `financials.income_statements[].currency_conversion.from` | Original currency | | `financials.income_statements[].currency_conversion.rate` | Conversion multiplier | | `financials.income_statements[].currency_conversion.method` | Conversion method | | `financials.income_statements[].currency_conversion.rate_start_date` | First rate date | | `financials.income_statements[].currency_conversion.rate_end_date` | Last rate date | | `financials.income_statements[].revenue` | revenue. Reported value; null if unavailable. | | `financials.income_statements[].cost_of_revenue` | Reported cost of goods and services sold. Other separately presented charges, including insurance and reinsurance expenses, can also affect gross profit. | | `financials.income_statements[].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. | | `financials.income_statements[].operating_expenses` | Reported operating expenses excluding the separately presented cost of revenue. Null when that subtotal is not reported. | | `financials.income_statements[].total_operating_expenses` | Reported total operating expenses, which may include cost of revenue. | | `financials.income_statements[].selling_general_and_administrative_expenses` | selling general and administrative expenses. Reported value; null if unavailable. | | `financials.income_statements[].administrative_expenses` | Reported administrative expenses. | | `financials.income_statements[].distribution_costs` | Reported distribution costs. | | `financials.income_statements[].research_and_development` | research and development. Reported value; null if unavailable. | | `financials.income_statements[].operating_income` | operating income. Reported value; null if unavailable. | | `financials.income_statements[].interest_expense` | Reported total interest expense for the period; broader finance costs and debt-only components are not substituted. | | `financials.income_statements[].pretax_income` | Reported profit or loss before income tax. | | `financials.income_statements[].income_tax_expense` | income tax expense. Reported value; null if unavailable. | | `financials.income_statements[].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. | | `financials.income_statements[].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. | | `financials.income_statements[].net_income_from_discontinued_operations` | Reported profit or loss from discontinued operations. | | `financials.income_statements[].preferred_dividends_impact` | Reported preferred-stock dividend and related income-statement adjustments that reduce profit available to common shareholders when positive. | | `financials.income_statements[].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. | | `financials.income_statements[].earnings_per_share` | Reported basic earnings per ordinary share in currency; not adjusted for depositary-receipt ratios. Never derived by adding quarterly EPS. | | `financials.income_statements[].earnings_per_share_diluted` | Reported diluted earnings per ordinary share in currency; not adjusted for depositary-receipt ratios. | | `financials.income_statements[].weighted_average_shares` | Reported weighted-average ordinary shares, not an end-of-period share count. Unaffected by currency conversion. | | `financials.income_statements[].weighted_average_shares_diluted` | Reported diluted weighted-average ordinary shares. Unaffected by currency conversion. | | `financials.income_statements[].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. | | `financials.income_statements[].ebitda` | EBIT plus cash-flow depreciation and amortization for the same period and reporting currency. Null when either input is unavailable. | | `financials.balance_sheets[].available_on` | Latest known availability date of the evidence used for this row | | `financials.balance_sheets[].year_over_year.prior_end_date` | End or measurement date of the comparable year-earlier statement | | `financials.balance_sheets[].year_over_year.prior_available_on` | Latest known availability date of the prior statement evidence | | `financials.balance_sheets[].year_over_year.currency` | Original reporting currency for monetary changes | | `financials.balance_sheets[].year_over_year.line_items[].field` | Standardized line-item name | | `financials.balance_sheets[].year_over_year.line_items[].change` | Current amount minus prior amount in original units | | `financials.balance_sheets[].year_over_year.line_items[].growth` | Change divided by prior amount. Null for a non-positive prior value or negative current value | | `financials.balance_sheets[].filing_date` | With include_sources=true, latest known filing date among the documents supporting this row | | `financials.balance_sheets[].source_documents[].document_id` | Filing directory key when available | | `financials.balance_sheets[].source_documents[].source_document_id` | Original source identifier, such as an SEC accession | | `financials.balance_sheets[].source_documents[].filing_date` | Date this document was filed | | `financials.balance_sheets[].source_documents[].url` | Link to the source document when available | | `financials.balance_sheets[].period` | Reporting period type | | `financials.balance_sheets[].fiscal_year` | Fiscal year | | `financials.balance_sheets[].fiscal_period` | Fiscal period label | | `financials.balance_sheets[].reporting_currency` | Original statement currency | | `financials.balance_sheets[].currency` | Currency of returned amounts | | `financials.balance_sheets[].currency_conversion.from` | Original currency | | `financials.balance_sheets[].currency_conversion.rate` | Conversion multiplier | | `financials.balance_sheets[].currency_conversion.method` | Conversion method | | `financials.balance_sheets[].currency_conversion.rate_date` | Closing rate date | | `financials.balance_sheets[].as_of` | Date at which these balances were measured. | | `financials.balance_sheets[].total_assets` | All recognized assets at the reporting date. | | `financials.balance_sheets[].current_assets` | Assets classified as current by the company. | | `financials.balance_sheets[].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. | | `financials.balance_sheets[].cash_and_equivalents` | Cash and cash equivalents, excluding separately classified restricted cash. | | `financials.balance_sheets[].inventory` | Net carrying value of inventories. | | `financials.balance_sheets[].current_investments` | Reported short-term investments or current marketable securities; not all current financial assets. | | `financials.balance_sheets[].trade_receivables` | Current trade receivables, net of allowances. | | `financials.balance_sheets[].property_plant_and_equipment` | Net carrying value of property, plant and equipment. | | `financials.balance_sheets[].goodwill` | Recognized goodwill, net of impairment. | | `financials.balance_sheets[].intangible_assets_excluding_goodwill` | Net intangible assets excluding goodwill. A finite-lived-only component is not substituted. | | `financials.balance_sheets[].total_liabilities` | Total liabilities; may be calculated from both reported current and non-current liabilities. | | `financials.balance_sheets[].current_liabilities` | Liabilities classified as current by the company. | | `financials.balance_sheets[].non_current_liabilities` | Liabilities classified as non-current by the company. May be calculated as total liabilities less current liabilities when both are known. | | `financials.balance_sheets[].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. | | `financials.balance_sheets[].non_current_debt` | Reported non-current debt or borrowings. Treatment of leases follows the reported concept. | | `financials.balance_sheets[].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. | | `financials.balance_sheets[].trade_payables` | Current trade accounts payable. | | `financials.balance_sheets[].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. | | `financials.balance_sheets[].equity_attributable_to_parent` | Equity attributable to the parent shareholders, excluding non-controlling interests. | | `financials.balance_sheets[].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. | | `financials.balance_sheets[].retained_earnings` | Accumulated retained earnings or deficit. | | `financials.balance_sheets[].liabilities_and_equity` | Reported combined liabilities and equity. | | `financials.balance_sheets[].outstanding_shares` | Reported shares outstanding at this exact balance-sheet date. Later cover-page share counts are excluded. Not affected by currency conversion. | | `financials.cash_flow_statements[].available_on` | Latest known availability date of the evidence used for this row | | `financials.cash_flow_statements[].year_over_year.prior_end_date` | End or measurement date of the comparable year-earlier statement | | `financials.cash_flow_statements[].year_over_year.prior_available_on` | Latest known availability date of the prior statement evidence | | `financials.cash_flow_statements[].year_over_year.currency` | Original reporting currency for monetary changes | | `financials.cash_flow_statements[].year_over_year.line_items[].field` | Standardized line-item name | | `financials.cash_flow_statements[].year_over_year.line_items[].change` | Current amount minus prior amount in original units | | `financials.cash_flow_statements[].year_over_year.line_items[].growth` | Change divided by prior amount. Null for a non-positive prior value or negative current value | | `financials.cash_flow_statements[].filing_date` | With include_sources=true, latest known filing date among the documents supporting this row | | `financials.cash_flow_statements[].source_documents[].document_id` | Filing directory key when available | | `financials.cash_flow_statements[].source_documents[].source_document_id` | Original source identifier, such as an SEC accession | | `financials.cash_flow_statements[].source_documents[].filing_date` | Date this document was filed | | `financials.cash_flow_statements[].source_documents[].url` | Link to the source document when available | | `financials.cash_flow_statements[].period` | Reporting period type | | `financials.cash_flow_statements[].fiscal_year` | Fiscal year | | `financials.cash_flow_statements[].fiscal_period` | Fiscal period label | | `financials.cash_flow_statements[].reporting_currency` | Original statement currency | | `financials.cash_flow_statements[].currency` | Currency of returned amounts | | `financials.cash_flow_statements[].start_date` | Period start | | `financials.cash_flow_statements[].end_date` | Period end | | `financials.cash_flow_statements[].currency_conversion.from` | Original currency | | `financials.cash_flow_statements[].currency_conversion.rate` | Conversion multiplier | | `financials.cash_flow_statements[].currency_conversion.method` | Conversion method | | `financials.cash_flow_statements[].currency_conversion.rate_start_date` | First rate date | | `financials.cash_flow_statements[].currency_conversion.rate_end_date` | Last rate date | | `financials.cash_flow_statements[].currency_conversion.beginning_cash.rate` | Closing exchange rate | | `financials.cash_flow_statements[].currency_conversion.beginning_cash.as_of` | Rate date | | `financials.cash_flow_statements[].currency_conversion.ending_cash.rate` | Closing exchange rate | | `financials.cash_flow_statements[].currency_conversion.ending_cash.as_of` | Rate date | | `financials.cash_flow_statements[].cash_balance_basis` | Shared cash definition of the beginning and ending balances; null when it cannot be established. | | `financials.cash_flow_statements[].beginning_cash_balance` | Cash balance on the day before start_date, using the same cash definition as ending_cash_balance. | | `financials.cash_flow_statements[].ending_cash_balance` | Cash balance at end_date. It is never summed across quarters. | | `financials.cash_flow_statements[].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. | | `financials.cash_flow_statements[].depreciation_and_amortization` | Reported depreciation and amortization adjustment; broader impairment totals are not substituted. | | `financials.cash_flow_statements[].share_based_compensation` | Share-based compensation adjustment. | | `financials.cash_flow_statements[].net_cash_flow_from_operations` | Net cash generated by or used in operating activities, including discontinued operations where reported in the total. | | `financials.cash_flow_statements[].capital_expenditure` | Negative cash payments to acquire property, plant and equipment. Broader purchases including intangibles are not substituted. | | `financials.cash_flow_statements[].free_cash_flow` | Operating cash flow plus negative capital expenditure. This definition excludes acquisitions and other investment spending. | | `financials.cash_flow_statements[].business_acquisitions` | Negative acquisition cash flow, net of cash acquired. | | `financials.cash_flow_statements[].business_disposals` | Cash received from business disposals, net of cash disposed. | | `financials.cash_flow_statements[].net_cash_flow_from_investing` | Net cash generated by or used in investing activities. | | `financials.cash_flow_statements[].debt_issued` | Reported debt-issuance proceeds, which may cover long-term debt only. | | `financials.cash_flow_statements[].debt_repaid` | Negative reported debt repayments, which may cover long-term debt only. | | `financials.cash_flow_statements[].equity_issued` | Share issuance proceeds. Option-exercise proceeds alone are not substituted. | | `financials.cash_flow_statements[].equity_repurchased` | Negative payments to repurchase shares. | | `financials.cash_flow_statements[].dividends_and_other_cash_distributions` | Negative reported dividend/distribution payments. A common-share-only amount is not substituted for the total. | | `financials.cash_flow_statements[].net_cash_flow_from_financing` | Net cash generated by or used in financing activities. | | `financials.cash_flow_statements[].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. | | `financials.cash_flow_statements[].effect_of_exchange_rate_changes` | Reported currency effects on cash, under the reporting framework. | | `financials.cash_flow_statements[].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. | | `reports[].document_id` | With include_sources=true, the identifier of the filing | | `reports[].filing_url` | With include_sources=true, the direct URL of the filing, or null when unavailable | | `reports[].report_date` | Date covered by the filing | | `reports[].period` | Report frequency, when known | | `reports[].currency` | Reporting currency, when known | | `reports[].income_statement.line_items[].label` | Presentation label | | `reports[].income_statement.line_items[].full_label` | Full label when available | | `reports[].income_statement.line_items[].value` | Amount in its stated unit, or null for headings or unavailable values | | `reports[].income_statement.line_items[].unit` | Currency code, currency per share (such as USD/shares), shares, ratio, or null | | `reports[].income_statement.line_items[].start_date` | First day of the row's period, or null for a balance | | `reports[].income_statement.line_items[].end_date` | Last day of the period or date of the balance | | `reports[].income_statement.line_items[].depth` | Nesting level in the statement, starting at zero | | `reports[].balance_sheet.line_items[].label` | Presentation label | | `reports[].balance_sheet.line_items[].full_label` | Full label when available | | `reports[].balance_sheet.line_items[].value` | Amount in its stated unit, or null for headings or unavailable values | | `reports[].balance_sheet.line_items[].unit` | Currency code, currency per share (such as USD/shares), shares, ratio, or null | | `reports[].balance_sheet.line_items[].start_date` | First day of the row's period, or null for a balance | | `reports[].balance_sheet.line_items[].end_date` | Last day of the period or date of the balance | | `reports[].balance_sheet.line_items[].depth` | Nesting level in the statement, starting at zero | | `reports[].cash_flow_statement.line_items[].label` | Presentation label | | `reports[].cash_flow_statement.line_items[].full_label` | Full label when available | | `reports[].cash_flow_statement.line_items[].value` | Amount in its stated unit, or null for headings or unavailable values | | `reports[].cash_flow_statement.line_items[].unit` | Currency code, currency per share (such as USD/shares), shares, ratio, or null | | `reports[].cash_flow_statement.line_items[].start_date` | First day of the row's period, or null for a balance | | `reports[].cash_flow_statement.line_items[].end_date` | Last day of the period or date of the balance | | `reports[].cash_flow_statement.line_items[].depth` | Nesting level in the statement, starting at zero | | `match` | Identifier lookup outcome. A found match can still have an empty page. | ## Errors {#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](https://financialdb.ai/documentation/api/errors-and-limits.md).