# Screen companies Find the companies that meet your conditions on financials, ratios, country of domicile, sector and industry. ## How it works {#how-it-works} - **A screen is a list of conditions, and a company has to meet all of them.** Each condition is a field, an operator and a value, such as `{"field": "domicile_country", "operator": "eq", "value": "GB"}`. [Get screener filters](https://financialdb.ai/documentation/api/screener/filters.md) lists every field you can use. - **Use the operators listed for each field.** Text matching ignores case. `domicile_country` is where a company is legally registered, as an ISO code, so the UK is `GB`, not `UK`. It is not where the company is headquartered. - **Percentages are decimals.** A 20% net margin is `0.2`. Write `20` and you're asking for margins of 2,000%, which narrows the field considerably. - **Each company is judged on its own latest period.** That's the latest of the type you pick, `annual` by default. Financial years end on different dates, so this compares each company's most recent results, not one calendar period. `from` drops companies whose latest report is older than a date you choose. - **Amounts are compared in one currency.** Everything is converted to `currency` (USD by default) first, so a $10 billion revenue floor means $10 billion for everyone. A value we can't convert is null, and null doesn't match. - **Missing data never matches, not even `ne`.** A company with no sector on file won't appear for `sector ne Energy`. - **Results are sorted by revenue, largest first, unless you choose otherwise.** Set `sort_by` to any numeric field or `end_date`, and `order` to `asc` or `desc`. A growth screen reads better sorted by `accounting_metrics.revenue_growth`. - **Sorting happens before paging.** Companies without a value sort last either way. Ask for the next page with `next_offset` and the same filters and sort. A company that reports in two currencies appears once for each. ## Request {#request} `POST /api/v1/screener` with your API key. AI assistants call it as the `screen_companies` tool, with the same parameters. ``` curl -X POST "https://financialdb.ai/api/v1/screener" \ -H "Authorization: Bearer $FDB_API_KEY" \ -H "Content-Type: application/json" -d '{}' ``` ## Parameters {#parameters} | Parameter | Type | Description | |---|---|---| | `include_sources` | boolean | Include available source documents and supporting evidence. Omit for data only. Default: `false`. | | `filters` | array | Conditions that must all hold: objects with field, operator and value. Default: `[]`. | | `fields` | array | Values to return, by field name. Name, identifiers, classification and dates are always included. Default: `["income_statements.revenue", "accounting_metrics.net_margin"]`. | | `sort_by` | string: income_statements.revenue, income_statements.cost_of_revenue, income_statements.gross_profit, income_statements.insurance_revenue, income_statements.insurance_service_expenses, income_statements.reinsurance_income_expense, income_statements.operating_expenses, income_statements.total_operating_expenses, income_statements.selling_general_and_administrative_expenses, income_statements.research_and_development, income_statements.distribution_costs, income_statements.administrative_expenses, income_statements.operating_income, income_statements.interest_expense, income_statements.pretax_income, income_statements.income_tax_expense, income_statements.ebit, income_statements.preferred_dividends_impact, income_statements.dividends_per_common_share, income_statements.net_income_including_non_controlling_interests, income_statements.net_income, income_statements.net_income_attributable_to_non_controlling_interests, income_statements.net_income_from_discontinued_operations, income_statements.net_income_available_to_common_shareholders, income_statements.earnings_per_share, income_statements.earnings_per_share_diluted, income_statements.weighted_average_shares, income_statements.weighted_average_shares_diluted, balance_sheets.total_assets, balance_sheets.current_assets, balance_sheets.non_current_assets, balance_sheets.cash_and_equivalents, balance_sheets.cash_and_equivalents_including_restricted, balance_sheets.inventory, balance_sheets.current_investments, balance_sheets.trade_receivables, balance_sheets.trade_and_other_receivables, balance_sheets.nontrade_receivables, balance_sheets.property_plant_and_equipment, balance_sheets.property_plant_and_equipment_including_right_of_use_assets, balance_sheets.goodwill, balance_sheets.goodwill_and_intangible_assets, balance_sheets.intangible_assets_excluding_goodwill, balance_sheets.non_current_investments, balance_sheets.investments, balance_sheets.deferred_tax_assets, balance_sheets.total_liabilities, balance_sheets.current_liabilities, balance_sheets.other_current_liabilities, balance_sheets.non_current_liabilities, balance_sheets.current_debt, balance_sheets.current_portion_of_long_term_debt, balance_sheets.short_term_borrowings, balance_sheets.commercial_paper, balance_sheets.non_current_debt, balance_sheets.total_debt, balance_sheets.trade_payables, balance_sheets.trade_and_other_payables, balance_sheets.current_deferred_revenue, balance_sheets.deposit_liabilities, balance_sheets.deferred_tax_liabilities, balance_sheets.total_equity, balance_sheets.equity_attributable_to_parent, balance_sheets.non_controlling_interests, balance_sheets.temporary_equity, balance_sheets.temporary_equity_attributable_to_parent, balance_sheets.redeemable_non_controlling_interests, balance_sheets.retained_earnings, balance_sheets.accumulated_other_comprehensive_income, balance_sheets.liabilities_and_equity, balance_sheets.outstanding_shares, cash_flow_statements.net_income_including_non_controlling_interests, cash_flow_statements.depreciation_and_amortization, cash_flow_statements.share_based_compensation, cash_flow_statements.net_cash_flow_from_operations, cash_flow_statements.capital_expenditure, cash_flow_statements.capital_expenditure_including_intangible_and_other_noncurrent_assets, cash_flow_statements.capital_expenditure_productive_assets, cash_flow_statements.business_acquisitions, cash_flow_statements.business_disposals, cash_flow_statements.investment_purchases, cash_flow_statements.investment_sales_and_maturities, cash_flow_statements.investment_sales, cash_flow_statements.investment_maturities, cash_flow_statements.net_cash_flow_from_investing, cash_flow_statements.debt_issued, cash_flow_statements.debt_repaid, cash_flow_statements.short_term_debt_net, cash_flow_statements.equity_issued, cash_flow_statements.equity_repurchased, cash_flow_statements.dividends_and_other_cash_distributions, cash_flow_statements.net_cash_flow_from_financing, cash_flow_statements.change_in_cash_and_equivalents, cash_flow_statements.change_in_cash_before_exchange_rate_effects, cash_flow_statements.effect_of_exchange_rate_changes, cash_flow_statements.business_acquisitions_and_disposals, cash_flow_statements.investment_acquisitions_and_disposals, cash_flow_statements.issuance_or_repayment_of_debt_securities, cash_flow_statements.issuance_or_purchase_of_equity_shares, cash_flow_statements.free_cash_flow, cash_flow_statements.broad_capital_expenditure, cash_flow_statements.broad_free_cash_flow, cash_flow_statements.beginning_cash_balance, cash_flow_statements.ending_cash_balance, accounting_metrics.gross_margin, accounting_metrics.operating_margin, accounting_metrics.net_margin_including_non_controlling_interests, accounting_metrics.net_margin, accounting_metrics.return_on_equity, accounting_metrics.return_on_assets, accounting_metrics.return_on_invested_capital, accounting_metrics.asset_turnover, accounting_metrics.inventory_turnover, accounting_metrics.receivables_turnover, accounting_metrics.days_sales_outstanding, accounting_metrics.days_inventory_outstanding, accounting_metrics.operating_cycle, accounting_metrics.working_capital_turnover, accounting_metrics.current_ratio, accounting_metrics.quick_ratio, accounting_metrics.cash_ratio, accounting_metrics.operating_cash_flow_ratio, accounting_metrics.debt_to_equity, accounting_metrics.debt_to_assets, accounting_metrics.interest_coverage, accounting_metrics.free_cash_flow_margin, accounting_metrics.payout_ratio, accounting_metrics.revenue_growth, accounting_metrics.earnings_growth, accounting_metrics.operating_income_growth, accounting_metrics.ebitda_growth, accounting_metrics.earnings_per_share_growth, accounting_metrics.free_cash_flow_growth, accounting_metrics.book_value_growth, accounting_metrics.earnings_per_share, accounting_metrics.book_value_per_share, accounting_metrics.free_cash_flow_per_share, end_date | Field to sort all matches by: any numeric field, or end_date. Missing values sort last. Default: `income_statements.revenue`. | | `order` | string: asc, desc | Sort direction. Default: `desc`. | | `period` | string: annual, quarterly, half_year, ttm | Period type each company is compared on. Default: `annual`. | | `currency` | string | Currency to compare and return amounts in. Ratios, share counts and days aren't converted. Default: `USD`. | | `from` | date | Skip companies whose latest report ends before this date. | | `limit` | integer: 1–100 | Results per page. Default: `20`. | | `offset` | integer: 0–9007199254740991 | Results to skip. Use next_offset from the previous page. Default: `0`. | ## Response {#response} JSON with these fields. A field the source doesn't report is null or left out. When nothing matches, `message` says why and what to ask instead. Empty answers are free. | Field | Description | |---|---| | `period` | Requested reporting period type | | `currency` | Requested output currency | | `sort_by` | Applied ranking field | | `order` | Applied ranking direction | | `results[].identifier.type` | Identifier scheme | | `results[].identifier.value` | Company identifier in that scheme | | `results[].name` | Company name | | `results[].domicile_country` | Country where the company is legally registered, as an ISO code such as GB. Not its headquarters. | | `results[].sector` | Business sector, by its label from get_screener_filters. | | `results[].industry` | Industry, by its label from get_screener_filters. | | `results[].start_date` | Period start | | `results[].end_date` | Period end | | `results[].period` | Reporting period type | | `results[].fiscal_year` | Fiscal year, when established | | `results[].fiscal_period` | Fiscal period label | | `results[].reporting_currency` | Original reporting currency | | `results[].currency` | Output monetary currency | | `results[].values.income_statements.revenue` | revenue. Reported value; null if unavailable. | | `results[].values.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. | | `results[].values.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. | | `results[].values.income_statements.insurance_revenue` | Reported insurance revenue component; may already be included in revenue. Do not add it to revenue. | | `results[].values.income_statements.insurance_service_expenses` | Reported insurance service expenses, separately presented from cost of sales. | | `results[].values.income_statements.reinsurance_income_expense` | Reported net reinsurance income (positive) or expense (negative), excluding finance effects. | | `results[].values.income_statements.operating_expenses` | Reported operating expenses excluding the separately presented cost of revenue. Null when that subtotal is not reported. | | `results[].values.income_statements.total_operating_expenses` | Reported total operating expenses, which may include cost of revenue. Do not add cost_of_revenue to this field. | | `results[].values.income_statements.selling_general_and_administrative_expenses` | selling general and administrative expenses. Reported value; null if unavailable. | | `results[].values.income_statements.research_and_development` | research and development. Reported value; null if unavailable. | | `results[].values.income_statements.distribution_costs` | distribution costs. Reported value; null if unavailable. | | `results[].values.income_statements.administrative_expenses` | administrative expenses. Reported value; null if unavailable. | | `results[].values.income_statements.operating_income` | operating income. Reported value; null if unavailable. | | `results[].values.income_statements.interest_expense` | Reported total interest expense for the period; broader finance costs and debt-only components are not substituted. | | `results[].values.income_statements.pretax_income` | Reported profit or loss before income tax. | | `results[].values.income_statements.income_tax_expense` | income tax expense. Reported value; null if unavailable. | | `results[].values.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. | | `results[].values.income_statements.preferred_dividends_impact` | Reported preferred-stock dividend and related income-statement adjustments to earnings available to common shareholders. A positive amount reduces parent profit available to common shareholders. Not a cash-dividend payment amount; absence is not assumed to mean zero. A declared preferred-dividend disclosure is accepted as the adjustment only when it exactly reconciles reported parent and common-shareholder profit in the same filing. | | `results[].values.income_statements.dividends_per_common_share` | Declared common dividends per share for the exact reporting period (or recognized per-share distributions under the applicable reporting framework). Paid-per-share amounts are not substituted. Returned only for reported periods; not summed or differenced across potentially different share bases. Converts with the period-average rate when currency is requested. | | `results[].values.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. | | `results[].values.income_statements.net_income` | Profit or loss attributable to shareholders of the parent company. | | `results[].values.income_statements.net_income_attributable_to_non_controlling_interests` | Profit or loss attributable to non-controlling interests. | | `results[].values.income_statements.net_income_from_discontinued_operations` | net income from discontinued operations. Reported value; null if unavailable. | | `results[].values.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. | | `results[].values.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. | | `results[].values.income_statements.earnings_per_share_diluted` | Reported diluted earnings per ordinary share in currency; not adjusted for depositary-receipt ratios. | | `results[].values.income_statements.weighted_average_shares` | Reported weighted-average ordinary shares, not an end-of-period share count. Unaffected by currency conversion. | | `results[].values.income_statements.weighted_average_shares_diluted` | Reported diluted weighted-average ordinary shares. Unaffected by currency conversion. | | `results[].values.balance_sheets.total_assets` | All recognized assets at the reporting date. | | `results[].values.balance_sheets.current_assets` | Assets classified as current by the company. | | `results[].values.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. | | `results[].values.balance_sheets.cash_and_equivalents` | Cash and cash equivalents, excluding separately classified restricted cash. | | `results[].values.balance_sheets.cash_and_equivalents_including_restricted` | Combined cash, cash equivalents and restricted cash when explicitly reported. | | `results[].values.balance_sheets.inventory` | Net carrying value of inventories. | | `results[].values.balance_sheets.current_investments` | Reported short-term investments or current marketable securities; not all current financial assets. | | `results[].values.balance_sheets.trade_receivables` | Current trade receivables, net of allowances. | | `results[].values.balance_sheets.trade_and_other_receivables` | Combined current trade and other receivables, reported or calculated from compatible trade and non-trade amounts when both are known. | | `results[].values.balance_sheets.nontrade_receivables` | Current non-trade receivables when separately reported. | | `results[].values.balance_sheets.property_plant_and_equipment` | Net carrying value of property, plant and equipment. | | `results[].values.balance_sheets.property_plant_and_equipment_including_right_of_use_assets` | Reported carrying amount of property, plant and equipment including right-of-use assets whose underlying assets would be classified as property, plant and equipment if owned. This broader amount is kept separate from property_plant_and_equipment. | | `results[].values.balance_sheets.goodwill` | Recognized goodwill, net of impairment. | | `results[].values.balance_sheets.goodwill_and_intangible_assets` | Combined goodwill and intangible assets, reported or calculated only when both components are known. | | `results[].values.balance_sheets.intangible_assets_excluding_goodwill` | Net intangible assets excluding goodwill. A finite-lived-only component is not substituted. | | `results[].values.balance_sheets.non_current_investments` | Reported long-term investments or non-current marketable securities. | | `results[].values.balance_sheets.investments` | Reported investments total, or sum of compatible current and non-current investments when both are known. Cash equivalents are excluded from the derived total. | | `results[].values.balance_sheets.deferred_tax_assets` | Non-current deferred tax assets, as reported under the applicable accounting presentation. | | `results[].values.balance_sheets.total_liabilities` | Total liabilities; may be calculated from both reported current and non-current liabilities. | | `results[].values.balance_sheets.current_liabilities` | Liabilities classified as current by the company. | | `results[].values.balance_sheets.other_current_liabilities` | Separately reported other current liabilities; used to validate a complete current-debt composition. | | `results[].values.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. | | `results[].values.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. | | `results[].values.balance_sheets.current_portion_of_long_term_debt` | Long-term debt due within the current classification period; a component of current debt. | | `results[].values.balance_sheets.short_term_borrowings` | Separately reported short-term borrowings. This component is not substituted for total current debt. | | `results[].values.balance_sheets.commercial_paper` | Outstanding commercial paper; may overlap with reported current debt. | | `results[].values.balance_sheets.non_current_debt` | Reported non-current debt or borrowings. Treatment of leases follows the reported concept. | | `results[].values.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. | | `results[].values.balance_sheets.trade_payables` | Current trade accounts payable. | | `results[].values.balance_sheets.trade_and_other_payables` | Combined current trade and other payables or accrued liabilities; a trade-only amount is not substituted. | | `results[].values.balance_sheets.current_deferred_revenue` | Current contract liabilities or deferred revenue. | | `results[].values.balance_sheets.deposit_liabilities` | Customer deposit liabilities when reported. | | `results[].values.balance_sheets.deferred_tax_liabilities` | Non-current deferred tax liabilities, as reported under the applicable accounting presentation. | | `results[].values.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. | | `results[].values.balance_sheets.equity_attributable_to_parent` | Equity attributable to the parent shareholders, excluding non-controlling interests. | | `results[].values.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. | | `results[].values.balance_sheets.temporary_equity` | Equity interests classified outside permanent equity and liabilities. Reported total, sum of known parent and redeemable non-controlling amounts, or a reported component confirmed to exhaust the difference between combined liabilities/equity, liabilities and permanent equity. | | `results[].values.balance_sheets.temporary_equity_attributable_to_parent` | Temporary equity attributable to the parent, such as redeemable preferred stock, when separately reported. | | `results[].values.balance_sheets.redeemable_non_controlling_interests` | Redeemable non-controlling equity interests outside permanent equity. Included in temporary_equity where that total is known; do not add both to liabilities and permanent equity. | | `results[].values.balance_sheets.retained_earnings` | Accumulated retained earnings or deficit. | | `results[].values.balance_sheets.accumulated_other_comprehensive_income` | Accumulated other comprehensive income or loss, net of tax. | | `results[].values.balance_sheets.liabilities_and_equity` | Reported combined liabilities and equity. | | `results[].values.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. | | `results[].values.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. | | `results[].values.cash_flow_statements.depreciation_and_amortization` | Reported depreciation and amortization adjustment; broader impairment totals are not substituted. | | `results[].values.cash_flow_statements.share_based_compensation` | Share-based compensation adjustment. | | `results[].values.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. | | `results[].values.cash_flow_statements.capital_expenditure` | Negative cash payments to acquire property, plant and equipment. Broader purchases including intangibles are not substituted. | | `results[].values.cash_flow_statements.capital_expenditure_including_intangible_and_other_noncurrent_assets` | Negative cash payments to acquire property, plant and equipment, intangible assets other than goodwill, investment property and other noncurrent assets. This broader reported amount is kept separate from capital_expenditure and is not substituted in free_cash_flow. | | `results[].values.cash_flow_statements.capital_expenditure_productive_assets` | Negative cash payments reported as acquisitions of productive assets (PaymentsToAcquireProductiveAssets) where the filing does not prove the line is property, plant and equipment only. It may include intangible and other long-lived assets, so it is kept separate from capital_expenditure and is not substituted in free_cash_flow. | | `results[].values.cash_flow_statements.business_acquisitions` | Negative acquisition cash flow, net of cash acquired. | | `results[].values.cash_flow_statements.business_disposals` | Cash received from business disposals, net of cash disposed. | | `results[].values.cash_flow_statements.investment_purchases` | Negative payments for the mapped investment category; coverage may follow the issuer’s securities classification. | | `results[].values.cash_flow_statements.investment_sales_and_maturities` | Combined investment disposal/maturity proceeds, reported or the sum of known sales and maturities. | | `results[].values.cash_flow_statements.investment_sales` | Reported proceeds from investment sales. | | `results[].values.cash_flow_statements.investment_maturities` | Reported proceeds from maturities, prepayments and calls. | | `results[].values.cash_flow_statements.net_cash_flow_from_investing` | Net cash generated by or used in investing activities. | | `results[].values.cash_flow_statements.debt_issued` | Reported debt-issuance proceeds, which may cover long-term debt only. | | `results[].values.cash_flow_statements.debt_repaid` | Negative reported debt repayments, which may cover long-term debt only. | | `results[].values.cash_flow_statements.short_term_debt_net` | Signed net short-term borrowing or commercial-paper cash flow. | | `results[].values.cash_flow_statements.equity_issued` | Share issuance proceeds. Option-exercise proceeds alone are not substituted. | | `results[].values.cash_flow_statements.equity_repurchased` | Negative payments to repurchase shares. | | `results[].values.cash_flow_statements.dividends_and_other_cash_distributions` | Negative reported dividend/distribution payments. A common-share-only amount is not substituted for the total. | | `results[].values.cash_flow_statements.net_cash_flow_from_financing` | Net cash generated by or used in financing activities. | | `results[].values.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. | | `results[].values.cash_flow_statements.change_in_cash_before_exchange_rate_effects` | Change in cash and cash equivalents before currency exchange effects. Excludes restricted cash unless included in the reported cash-and-equivalents definition. | | `results[].values.cash_flow_statements.effect_of_exchange_rate_changes` | Reported currency effects on cash, under the reporting framework. | | `results[].values.cash_flow_statements.business_acquisitions_and_disposals` | Net business acquisition/disposal cash flow when both components are known. | | `results[].values.cash_flow_statements.investment_acquisitions_and_disposals` | Net investment purchases and disposals/maturities when both are known. | | `results[].values.cash_flow_statements.issuance_or_repayment_of_debt_securities` | Net issued debt, repaid debt and short-term borrowing cash flows when all components are known. | | `results[].values.cash_flow_statements.issuance_or_purchase_of_equity_shares` | Net share issuance and repurchases when both are known. | | `results[].values.cash_flow_statements.free_cash_flow` | Operating cash flow plus negative capital expenditure. This definition excludes acquisitions and other investment spending. | | `results[].values.cash_flow_statements.broad_capital_expenditure` | The single broader reported purchase line, when available. Otherwise, the negative sum of separately reported PPE and intangible cash purchases only when one owned, reconciled investing face proves both operands and their scope. Sources identify both original operands for this derived measure; reported combined fields remain unchanged. Financial investments, business acquisitions and disposal receipts are excluded from the separate-purchase derivation. Null for ambiguous or incompatible scope. | | `results[].values.cash_flow_statements.broad_free_cash_flow` | Operating cash flow plus negative broad_capital_expenditure. A broader-basis measure kept separate from free_cash_flow. | | `results[].values.cash_flow_statements.beginning_cash_balance` | Cash balance on the day before start_date, using the same cash definition as ending_cash_balance. | | `results[].values.cash_flow_statements.ending_cash_balance` | Cash balance at end_date. It is never summed across quarters. | | `results[].values.accounting_metrics.gross_margin` | Gross profit divided by revenue. | | `results[].values.accounting_metrics.operating_margin` | Operating income divided by revenue. | | `results[].values.accounting_metrics.net_margin_including_non_controlling_interests` | Consolidated net income divided by revenue. | | `results[].values.accounting_metrics.net_margin` | Profit attributable to the parent divided by revenue. | | `results[].values.accounting_metrics.return_on_equity` | Parent profit divided by average opening and closing parent equity; not annualized. | | `results[].values.accounting_metrics.return_on_assets` | Consolidated profit divided by average opening and closing assets; not annualized. | | `results[].values.accounting_metrics.return_on_invested_capital` | Operating income after applying the effective tax rate (income tax expense divided by positive pretax income), divided by average opening and closing invested capital (total debt plus total equity less cash and equivalents). Tax rates outside 0–100% and non-positive average capital return null. The return covers the selected period. | | `results[].values.accounting_metrics.asset_turnover` | Revenue divided by average assets over this period. | | `results[].values.accounting_metrics.inventory_turnover` | Cost of revenue divided by average inventory over this period. | | `results[].values.accounting_metrics.receivables_turnover` | Revenue divided by average trade receivables; broad receivables are not substituted. | | `results[].values.accounting_metrics.days_sales_outstanding` | Actual days in the period divided by receivables turnover. | | `results[].values.accounting_metrics.days_inventory_outstanding` | Actual days in the period divided by inventory turnover. | | `results[].values.accounting_metrics.operating_cycle` | Days sales outstanding plus days inventory outstanding. | | `results[].values.accounting_metrics.working_capital_turnover` | Revenue divided by average current assets less current liabilities. | | `results[].values.accounting_metrics.current_ratio` | Closing current assets divided by current liabilities. | | `results[].values.accounting_metrics.quick_ratio` | Closing cash, current investments and trade receivables divided by current liabilities; every component must be known. | | `results[].values.accounting_metrics.cash_ratio` | Closing cash and cash equivalents divided by current liabilities. | | `results[].values.accounting_metrics.operating_cash_flow_ratio` | Operating cash flow divided by closing current liabilities; not annualized. | | `results[].values.accounting_metrics.debt_to_equity` | Closing total debt divided by total equity. | | `results[].values.accounting_metrics.debt_to_assets` | Closing total debt divided by total assets. | | `results[].values.accounting_metrics.interest_coverage` | EBIT divided by interest expense. | | `results[].values.accounting_metrics.free_cash_flow_margin` | Operating cash flow less gross PPE cash expenditure, divided by revenue; not issuer-adjusted free cash flow. Often unsuitable for financial institutions. | | `results[].values.accounting_metrics.payout_ratio` | Declared dividends per common share divided by basic earnings per share. | | `results[].values.accounting_metrics.revenue_growth` | Revenue growth against the comparable year-earlier period; a non-positive base returns null. | | `results[].values.accounting_metrics.earnings_growth` | Parent-profit growth against the comparable year-earlier period; a non-positive base returns null. | | `results[].values.accounting_metrics.operating_income_growth` | Operating-income growth against the comparable year-earlier period; a non-positive base returns null. | | `results[].values.accounting_metrics.ebitda_growth` | Growth in EBIT plus depreciation and amortization against the comparable year-earlier period. Missing or incompatible inputs and a non-positive base return null. | | `results[].values.accounting_metrics.earnings_per_share_growth` | Basic earnings-per-share growth against the comparable year-earlier period; a non-positive base returns null. | | `results[].values.accounting_metrics.free_cash_flow_growth` | Free-cash-flow growth against the comparable year-earlier period; a non-positive base returns null. | | `results[].values.accounting_metrics.book_value_growth` | Parent-equity growth against the comparable year-earlier period; a non-positive base returns null. | | `results[].values.accounting_metrics.earnings_per_share` | Reported basic earnings per share. | | `results[].values.accounting_metrics.book_value_per_share` | Closing parent equity divided by closing common shares outstanding. | | `results[].values.accounting_metrics.free_cash_flow_per_share` | Period free cash flow divided by basic weighted-average common shares. | | `next_offset` | Offset of the next page; null on the last page | | `coverage.reports` | Candidate reports for this period and date bound, before filters; not a unique-company count | | `coverage.missing_name` | Candidate reports missing a company name | | `coverage.missing_domicile_country` | Candidate reports missing domicile_country | | `coverage.missing_sector` | Candidate reports missing sector | | `coverage.missing_industry` | Candidate reports missing industry | | `coverage.unavailable_conversion` | Reports passing text filters with an unavailable conversion for a requested, filtered or sorted value | | `coverage.matched` | Matching reports before pagination; not a unique-company count | | `message` | Only when nothing matches: why, and what to try instead | ## 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).