Skip to content

Screen companies

Find the companies that meet your conditions on financials, ratios, country of domicile, sector and industry.

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 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

POST /api/v1/screener with your API key. AI assistants call it as the screen_companies tool, with the same parameters.

Parameters

include_sourcesboolean

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

Default: false

filtersarray of objects

Conditions that must all hold: objects with field, operator and value.

Show child parameters
fieldstringrequired

One of: domicile_country, sector, industry, 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 …

operatorstringrequired

One of: eq, ne, gt, gte, lt, lte, in

valuenumber or string or arrayrequired
fieldsarray

Values to return, by field name. Name, identifiers, classification and dates are always included.

Default: ["income_statements.revenue","accounting_metrics.net_margin"]

sort_bystring

Field to sort all matches by: any numeric field, or end_date. Missing values sort last.

Default: income_statements.revenue · One of: 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

orderstring

Sort direction.

Default: desc · One of: asc, desc

periodstring

Period type each company is compared on.

Default: annual · One of: annual, quarterly, half_year, ttm

currencystring

Currency to compare and return amounts in. Ratios, share counts and days aren't converted.

Default: USD

fromdate

Skip companies whose latest report ends before this date.

YYYY-MM-DD

limitinteger

Results per page.

Default: 20 · From 1 to 100

offsetinteger

Results to skip. Use next_offset from the previous page.

Default: 0 · From 0 to 9007199254740991

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.

period

Requested reporting period type

currency

Requested output currency

sort_by

Applied ranking field

order

Applied ranking direction

resultsarray of objectsrequired
Show child attributes
identifierobject
Show child attributes
type

Identifier scheme

value

Company identifier in that scheme

name

Company name

domicile_country

Country where the company is legally registered, as an ISO code such as GB. Not its headquarters.

sector

Business sector, by its label from get_screener_filters.

industry

Industry, by its label from get_screener_filters.

start_date

Period start

end_date

Period end

period

Reporting period type

fiscal_year

Fiscal year, when established

fiscal_period

Fiscal period label

reporting_currency

Original reporting currency

currency

Output monetary currency

valuesobject
Show child attributes
income_statements.revenue

revenue. Reported value; null if unavailable.

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.

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.

income_statements.insurance_revenue

Reported insurance revenue component; may already be included in revenue. Do not add it to revenue.

income_statements.insurance_service_expenses

Reported insurance service expenses, separately presented from cost of sales.

income_statements.reinsurance_income_expense

Reported net reinsurance income (positive) or expense (negative), excluding finance effects.

income_statements.operating_expenses

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

income_statements.total_operating_expenses

Reported total operating expenses, which may include cost of revenue. Do not add cost_of_revenue to this field.

income_statements.selling_general_and_administrative_expenses

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

income_statements.research_and_development

research and development. Reported value; null if unavailable.

income_statements.distribution_costs

distribution costs. Reported value; null if unavailable.

income_statements.administrative_expenses

administrative expenses. Reported value; null if unavailable.

income_statements.operating_income

operating income. Reported value; null if unavailable.

income_statements.interest_expense

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

income_statements.pretax_income

Reported profit or loss before income tax.

income_statements.income_tax_expense

income tax expense. Reported value; null if unavailable.

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.

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.

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.

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.

income_statements.net_income

Profit or loss attributable to shareholders of the parent company.

income_statements.net_income_attributable_to_non_controlling_interests

Profit or loss attributable to non-controlling interests.

income_statements.net_income_from_discontinued_operations

net income from discontinued operations. Reported value; null if unavailable.

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.

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.

income_statements.earnings_per_share_diluted

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

income_statements.weighted_average_shares

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

income_statements.weighted_average_shares_diluted

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

balance_sheets.total_assets

All recognized assets at the reporting date.

balance_sheets.current_assets

Assets classified as current by the company.

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.

balance_sheets.cash_and_equivalents

Cash and cash equivalents, excluding separately classified restricted cash.

balance_sheets.cash_and_equivalents_including_restricted

Combined cash, cash equivalents and restricted cash when explicitly reported.

balance_sheets.inventory

Net carrying value of inventories.

balance_sheets.current_investments

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

balance_sheets.trade_receivables

Current trade receivables, net of allowances.

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.

balance_sheets.nontrade_receivables

Current non-trade receivables when separately reported.

balance_sheets.property_plant_and_equipment

Net carrying value of property, plant and equipment.

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.

balance_sheets.goodwill

Recognized goodwill, net of impairment.

balance_sheets.goodwill_and_intangible_assets

Combined goodwill and intangible assets, reported or calculated only when both components are known.

balance_sheets.intangible_assets_excluding_goodwill

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

balance_sheets.non_current_investments

Reported long-term investments or non-current marketable securities.

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.

balance_sheets.deferred_tax_assets

Non-current deferred tax assets, as reported under the applicable accounting presentation.

balance_sheets.total_liabilities

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

balance_sheets.current_liabilities

Liabilities classified as current by the company.

balance_sheets.other_current_liabilities

Separately reported other current liabilities; used to validate a complete current-debt composition.

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.

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.

balance_sheets.current_portion_of_long_term_debt

Long-term debt due within the current classification period; a component of current debt.

balance_sheets.short_term_borrowings

Separately reported short-term borrowings. This component is not substituted for total current debt.

balance_sheets.commercial_paper

Outstanding commercial paper; may overlap with reported current debt.

balance_sheets.non_current_debt

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

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.

balance_sheets.trade_payables

Current trade accounts payable.

balance_sheets.trade_and_other_payables

Combined current trade and other payables or accrued liabilities; a trade-only amount is not substituted.

balance_sheets.current_deferred_revenue

Current contract liabilities or deferred revenue.

balance_sheets.deposit_liabilities

Customer deposit liabilities when reported.

balance_sheets.deferred_tax_liabilities

Non-current deferred tax liabilities, as reported under the applicable accounting presentation.

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.

balance_sheets.equity_attributable_to_parent

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

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.

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.

balance_sheets.temporary_equity_attributable_to_parent

Temporary equity attributable to the parent, such as redeemable preferred stock, when separately reported.

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.

balance_sheets.retained_earnings

Accumulated retained earnings or deficit.

balance_sheets.accumulated_other_comprehensive_income

Accumulated other comprehensive income or loss, net of tax.

balance_sheets.liabilities_and_equity

Reported combined liabilities and equity.

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.

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.

cash_flow_statements.depreciation_and_amortization

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

cash_flow_statements.share_based_compensation

Share-based compensation adjustment.

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.

cash_flow_statements.capital_expenditure

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

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.

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.

cash_flow_statements.business_acquisitions

Negative acquisition cash flow, net of cash acquired.

cash_flow_statements.business_disposals

Cash received from business disposals, net of cash disposed.

cash_flow_statements.investment_purchases

Negative payments for the mapped investment category; coverage may follow the issuer’s securities classification.

cash_flow_statements.investment_sales_and_maturities

Combined investment disposal/maturity proceeds, reported or the sum of known sales and maturities.

cash_flow_statements.investment_sales

Reported proceeds from investment sales.

cash_flow_statements.investment_maturities

Reported proceeds from maturities, prepayments and calls.

cash_flow_statements.net_cash_flow_from_investing

Net cash generated by or used in investing activities.

cash_flow_statements.debt_issued

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

cash_flow_statements.debt_repaid

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

cash_flow_statements.short_term_debt_net

Signed net short-term borrowing or commercial-paper cash flow.

cash_flow_statements.equity_issued

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

cash_flow_statements.equity_repurchased

Negative payments to repurchase shares.

cash_flow_statements.dividends_and_other_cash_distributions

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

cash_flow_statements.net_cash_flow_from_financing

Net cash generated by or used in financing activities.

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.

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.

cash_flow_statements.effect_of_exchange_rate_changes

Reported currency effects on cash, under the reporting framework.

cash_flow_statements.business_acquisitions_and_disposals

Net business acquisition/disposal cash flow when both components are known.

cash_flow_statements.investment_acquisitions_and_disposals

Net investment purchases and disposals/maturities when both are known.

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.

cash_flow_statements.issuance_or_purchase_of_equity_shares

Net share issuance and repurchases when both are known.

cash_flow_statements.free_cash_flow

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

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.

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.

cash_flow_statements.beginning_cash_balance

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

cash_flow_statements.ending_cash_balance

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

accounting_metrics.gross_margin

Gross profit divided by revenue.

accounting_metrics.operating_margin

Operating income divided by revenue.

accounting_metrics.net_margin_including_non_controlling_interests

Consolidated net income divided by revenue.

accounting_metrics.net_margin

Profit attributable to the parent divided by revenue.

accounting_metrics.return_on_equity

Parent profit divided by average opening and closing parent equity; not annualized.

accounting_metrics.return_on_assets

Consolidated profit divided by average opening and closing assets; not annualized.

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.

accounting_metrics.asset_turnover

Revenue divided by average assets over this period.

accounting_metrics.inventory_turnover

Cost of revenue divided by average inventory over this period.

accounting_metrics.receivables_turnover

Revenue divided by average trade receivables; broad receivables are not substituted.

accounting_metrics.days_sales_outstanding

Actual days in the period divided by receivables turnover.

accounting_metrics.days_inventory_outstanding

Actual days in the period divided by inventory turnover.

accounting_metrics.operating_cycle

Days sales outstanding plus days inventory outstanding.

accounting_metrics.working_capital_turnover

Revenue divided by average current assets less current liabilities.

accounting_metrics.current_ratio

Closing current assets divided by current liabilities.

accounting_metrics.quick_ratio

Closing cash, current investments and trade receivables divided by current liabilities; every component must be known.

accounting_metrics.cash_ratio

Closing cash and cash equivalents divided by current liabilities.

accounting_metrics.operating_cash_flow_ratio

Operating cash flow divided by closing current liabilities; not annualized.

accounting_metrics.debt_to_equity

Closing total debt divided by total equity.

accounting_metrics.debt_to_assets

Closing total debt divided by total assets.

accounting_metrics.interest_coverage

EBIT divided by interest expense.

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.

accounting_metrics.payout_ratio

Declared dividends per common share divided by basic earnings per share.

accounting_metrics.revenue_growth

Revenue growth against the comparable year-earlier period; a non-positive base returns null.

accounting_metrics.earnings_growth

Parent-profit growth against the comparable year-earlier period; a non-positive base returns null.

accounting_metrics.operating_income_growth

Operating-income growth against the comparable year-earlier period; a non-positive base returns null.

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.

accounting_metrics.earnings_per_share_growth

Basic earnings-per-share growth against the comparable year-earlier period; a non-positive base returns null.

accounting_metrics.free_cash_flow_growth

Free-cash-flow growth against the comparable year-earlier period; a non-positive base returns null.

accounting_metrics.book_value_growth

Parent-equity growth against the comparable year-earlier period; a non-positive base returns null.

accounting_metrics.earnings_per_share

Reported basic earnings per share.

accounting_metrics.book_value_per_share

Closing parent equity divided by closing common shares outstanding.

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

coverageobject
Show child attributes
reports

Candidate reports for this period and date bound, before filters; not a unique-company count

missing_name

Candidate reports missing a company name

missing_domicile_country

Candidate reports missing domicile_country

missing_sector

Candidate reports missing sector

missing_industry

Candidate reports missing industry

unavailable_conversion

Reports passing text filters with an unavailable conversion for a requested, filtered or sorted value

matched

Matching reports before pagination; not a unique-company count

message

Only when nothing matches: why, and what to try instead

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