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_countryis where a company is legally registered, as an ISO code, so the UK isGB, notUK. It is not where the company is headquartered. -
Percentages are decimals. A 20% net margin is
0.2. Write20and 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,
annualby default. Financial years end on different dates, so this compares each company's most recent results, not one calendar period.fromdrops 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 forsector ne Energy. -
Results are sorted by revenue, largest first, unless you choose otherwise. Set
sort_byto any numeric field orend_date, andordertoascordesc. A growth screen reads better sorted byaccounting_metrics.revenue_growth. -
Sorting happens before paging. Companies without a value sort last either way. Ask for the next page with
next_offsetand 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.
periodRequested reporting period type
currencyRequested output currency
sort_byApplied ranking field
orderApplied ranking direction
resultsarray of objectsrequired
Show child attributes
identifierobject
Show child attributes
typeIdentifier scheme
valueCompany identifier in that scheme
nameCompany name
domicile_countryCountry where the company is legally registered, as an ISO code such as GB. Not its headquarters.
sectorBusiness sector, by its label from get_screener_filters.
industryIndustry, by its label from get_screener_filters.
start_datePeriod start
end_datePeriod end
periodReporting period type
fiscal_yearFiscal year, when established
fiscal_periodFiscal period label
reporting_currencyOriginal reporting currency
currencyOutput monetary currency
valuesobject
Show child attributes
income_statements.revenuerevenue. Reported value; null if unavailable.
income_statements.cost_of_revenueReported cost of goods and services sold. Other separately presented charges, including insurance and reinsurance expenses, can also affect gross profit.
income_statements.gross_profitReported 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_revenueReported insurance revenue component; may already be included in revenue. Do not add it to revenue.
income_statements.insurance_service_expensesReported insurance service expenses, separately presented from cost of sales.
income_statements.reinsurance_income_expenseReported net reinsurance income (positive) or expense (negative), excluding finance effects.
income_statements.operating_expensesReported operating expenses excluding the separately presented cost of revenue. Null when that subtotal is not reported.
income_statements.total_operating_expensesReported total operating expenses, which may include cost of revenue. Do not add cost_of_revenue to this field.
income_statements.selling_general_and_administrative_expensesselling general and administrative expenses. Reported value; null if unavailable.
income_statements.research_and_developmentresearch and development. Reported value; null if unavailable.
income_statements.distribution_costsdistribution costs. Reported value; null if unavailable.
income_statements.administrative_expensesadministrative expenses. Reported value; null if unavailable.
income_statements.operating_incomeoperating income. Reported value; null if unavailable.
income_statements.interest_expenseReported total interest expense for the period; broader finance costs and debt-only components are not substituted.
income_statements.pretax_incomeReported profit or loss before income tax.
income_statements.income_tax_expenseincome tax expense. Reported value; null if unavailable.
income_statements.ebitEarnings before interest and tax, defined here as pretax income plus total interest expense for the same period and filing. Interest income remains included in pretax income. Broad finance costs, partial debt-interest amounts and operating income are not substituted. Null when compatible inputs are unavailable.
income_statements.preferred_dividends_impactReported 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_shareDeclared 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_interestsConsolidated profit or loss, including non-controlling interests. For a US GAAP filing that reports neither consolidated profit nor a non-controlling share for the period (ASC 810 requires both when a non-controlling interest exists), it equals profit attributable to the parent; otherwise it is never substituted with that figure.
income_statements.net_incomeProfit or loss attributable to shareholders of the parent company.
income_statements.net_income_attributable_to_non_controlling_interestsProfit or loss attributable to non-controlling interests.
income_statements.net_income_from_discontinued_operationsnet income from discontinued operations. Reported value; null if unavailable.
income_statements.net_income_available_to_common_shareholdersReported profit available to common shareholders, or parent profit less the preferred-dividend impact when both inputs belong to the same filing and period. Missing adjustments are not zero.
income_statements.earnings_per_shareReported basic earnings per ordinary share in currency; not adjusted for depositary-receipt ratios. Never derived by adding quarterly EPS.
income_statements.earnings_per_share_dilutedReported diluted earnings per ordinary share in currency; not adjusted for depositary-receipt ratios.
income_statements.weighted_average_sharesReported weighted-average ordinary shares, not an end-of-period share count. Unaffected by currency conversion.
income_statements.weighted_average_shares_dilutedReported diluted weighted-average ordinary shares. Unaffected by currency conversion.
balance_sheets.total_assetsAll recognized assets at the reporting date.
balance_sheets.current_assetsAssets classified as current by the company.
balance_sheets.non_current_assetsAssets classified as non-current; includes fixed assets under UK reporting. May be calculated as total assets less current assets when both are known.
balance_sheets.cash_and_equivalentsCash and cash equivalents, excluding separately classified restricted cash.
balance_sheets.cash_and_equivalents_including_restrictedCombined cash, cash equivalents and restricted cash when explicitly reported.
balance_sheets.inventoryNet carrying value of inventories.
balance_sheets.current_investmentsReported short-term investments or current marketable securities; not all current financial assets.
balance_sheets.trade_receivablesCurrent trade receivables, net of allowances.
balance_sheets.trade_and_other_receivablesCombined current trade and other receivables, reported or calculated from compatible trade and non-trade amounts when both are known.
balance_sheets.nontrade_receivablesCurrent non-trade receivables when separately reported.
balance_sheets.property_plant_and_equipmentNet carrying value of property, plant and equipment.
balance_sheets.property_plant_and_equipment_including_right_of_use_assetsReported 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.goodwillRecognized goodwill, net of impairment.
balance_sheets.goodwill_and_intangible_assetsCombined goodwill and intangible assets, reported or calculated only when both components are known.
balance_sheets.intangible_assets_excluding_goodwillNet intangible assets excluding goodwill. A finite-lived-only component is not substituted.
balance_sheets.non_current_investmentsReported long-term investments or non-current marketable securities.
balance_sheets.investmentsReported 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_assetsNon-current deferred tax assets, as reported under the applicable accounting presentation.
balance_sheets.total_liabilitiesTotal liabilities; may be calculated from both reported current and non-current liabilities.
balance_sheets.current_liabilitiesLiabilities classified as current by the company.
balance_sheets.other_current_liabilitiesSeparately reported other current liabilities; used to validate a complete current-debt composition.
balance_sheets.non_current_liabilitiesLiabilities classified as non-current by the company. May be calculated as total liabilities less current liabilities when both are known.
balance_sheets.current_debtReported current debt, or compatible short-term borrowings plus current long-term maturities. Commercial paper plus maturities is used only when those amounts and the other current-liability categories reconcile exactly to current liabilities.
balance_sheets.current_portion_of_long_term_debtLong-term debt due within the current classification period; a component of current debt.
balance_sheets.short_term_borrowingsSeparately reported short-term borrowings. This component is not substituted for total current debt.
balance_sheets.commercial_paperOutstanding commercial paper; may overlap with reported current debt.
balance_sheets.non_current_debtReported non-current debt or borrowings. Treatment of leases follows the reported concept.
balance_sheets.total_debtReported debt total or the sum of known current and non-current debt. Missing components are not zero; this is not a harmonized lease-adjusted measure.
balance_sheets.trade_payablesCurrent trade accounts payable.
balance_sheets.trade_and_other_payablesCombined current trade and other payables or accrued liabilities; a trade-only amount is not substituted.
balance_sheets.current_deferred_revenueCurrent contract liabilities or deferred revenue.
balance_sheets.deposit_liabilitiesCustomer deposit liabilities when reported.
balance_sheets.deferred_tax_liabilitiesNon-current deferred tax liabilities, as reported under the applicable accounting presentation.
balance_sheets.total_equityPermanent equity including non-controlling interests. Reported or calculated from both known components. Parent equity is accepted alone only when it closes the reported combined liabilities/equity equation exactly and no nonzero temporary or non-controlling equity is reported.
balance_sheets.equity_attributable_to_parentEquity attributable to the parent shareholders, excluding non-controlling interests.
balance_sheets.non_controlling_interestsNon-controlling interests classified within equity; excludes temporary or redeemable interests outside equity. May be calculated as total equity less parent equity when both are known.
balance_sheets.temporary_equityEquity 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_parentTemporary equity attributable to the parent, such as redeemable preferred stock, when separately reported.
balance_sheets.redeemable_non_controlling_interestsRedeemable 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_earningsAccumulated retained earnings or deficit.
balance_sheets.accumulated_other_comprehensive_incomeAccumulated other comprehensive income or loss, net of tax.
balance_sheets.liabilities_and_equityReported combined liabilities and equity.
balance_sheets.outstanding_sharesReported 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_interestsReported consolidated profit or loss for the period. For a US GAAP filing that tags neither consolidated profit nor a non-controlling share (ASC 810 requires both when a non-controlling interest exists), the reported parent profit.
cash_flow_statements.depreciation_and_amortizationReported depreciation and amortization adjustment; broader impairment totals are not substituted.
cash_flow_statements.share_based_compensationShare-based compensation adjustment.
cash_flow_statements.net_cash_flow_from_operationsNet cash generated by or used in operating activities, including discontinued operations where reported in the total.
cash_flow_statements.capital_expenditureNegative 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_assetsNegative 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_assetsNegative 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_acquisitionsNegative acquisition cash flow, net of cash acquired.
cash_flow_statements.business_disposalsCash received from business disposals, net of cash disposed.
cash_flow_statements.investment_purchasesNegative payments for the mapped investment category; coverage may follow the issuer’s securities classification.
cash_flow_statements.investment_sales_and_maturitiesCombined investment disposal/maturity proceeds, reported or the sum of known sales and maturities.
cash_flow_statements.investment_salesReported proceeds from investment sales.
cash_flow_statements.investment_maturitiesReported proceeds from maturities, prepayments and calls.
cash_flow_statements.net_cash_flow_from_investingNet cash generated by or used in investing activities.
cash_flow_statements.debt_issuedReported debt-issuance proceeds, which may cover long-term debt only.
cash_flow_statements.debt_repaidNegative reported debt repayments, which may cover long-term debt only.
cash_flow_statements.short_term_debt_netSigned net short-term borrowing or commercial-paper cash flow.
cash_flow_statements.equity_issuedShare issuance proceeds. Option-exercise proceeds alone are not substituted.
cash_flow_statements.equity_repurchasedNegative payments to repurchase shares.
cash_flow_statements.dividends_and_other_cash_distributionsNegative reported dividend/distribution payments. A common-share-only amount is not substituted for the total.
cash_flow_statements.net_cash_flow_from_financingNet cash generated by or used in financing activities.
cash_flow_statements.change_in_cash_and_equivalentsReported cash change including currency effects. The cash_balance_basis identifies whether restricted cash is included when boundary balances are established.
cash_flow_statements.change_in_cash_before_exchange_rate_effectsChange 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_changesReported currency effects on cash, under the reporting framework.
cash_flow_statements.business_acquisitions_and_disposalsNet business acquisition/disposal cash flow when both components are known.
cash_flow_statements.investment_acquisitions_and_disposalsNet investment purchases and disposals/maturities when both are known.
cash_flow_statements.issuance_or_repayment_of_debt_securitiesNet issued debt, repaid debt and short-term borrowing cash flows when all components are known.
cash_flow_statements.issuance_or_purchase_of_equity_sharesNet share issuance and repurchases when both are known.
cash_flow_statements.free_cash_flowOperating cash flow plus negative capital expenditure. This definition excludes acquisitions and other investment spending.
cash_flow_statements.broad_capital_expenditureThe 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_flowOperating cash flow plus negative broad_capital_expenditure. A broader-basis measure kept separate from free_cash_flow.
cash_flow_statements.beginning_cash_balanceCash balance on the day before start_date, using the same cash definition as ending_cash_balance.
cash_flow_statements.ending_cash_balanceCash balance at end_date. It is never summed across quarters.
accounting_metrics.gross_marginGross profit divided by revenue.
accounting_metrics.operating_marginOperating income divided by revenue.
accounting_metrics.net_margin_including_non_controlling_interestsConsolidated net income divided by revenue.
accounting_metrics.net_marginProfit attributable to the parent divided by revenue.
accounting_metrics.return_on_equityParent profit divided by average opening and closing parent equity; not annualized.
accounting_metrics.return_on_assetsConsolidated profit divided by average opening and closing assets; not annualized.
accounting_metrics.return_on_invested_capitalOperating 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_turnoverRevenue divided by average assets over this period.
accounting_metrics.inventory_turnoverCost of revenue divided by average inventory over this period.
accounting_metrics.receivables_turnoverRevenue divided by average trade receivables; broad receivables are not substituted.
accounting_metrics.days_sales_outstandingActual days in the period divided by receivables turnover.
accounting_metrics.days_inventory_outstandingActual days in the period divided by inventory turnover.
accounting_metrics.operating_cycleDays sales outstanding plus days inventory outstanding.
accounting_metrics.working_capital_turnoverRevenue divided by average current assets less current liabilities.
accounting_metrics.current_ratioClosing current assets divided by current liabilities.
accounting_metrics.quick_ratioClosing cash, current investments and trade receivables divided by current liabilities; every component must be known.
accounting_metrics.cash_ratioClosing cash and cash equivalents divided by current liabilities.
accounting_metrics.operating_cash_flow_ratioOperating cash flow divided by closing current liabilities; not annualized.
accounting_metrics.debt_to_equityClosing total debt divided by total equity.
accounting_metrics.debt_to_assetsClosing total debt divided by total assets.
accounting_metrics.interest_coverageEBIT divided by interest expense.
accounting_metrics.free_cash_flow_marginOperating cash flow less gross PPE cash expenditure, divided by revenue; not issuer-adjusted free cash flow. Often unsuitable for financial institutions.
accounting_metrics.payout_ratioDeclared dividends per common share divided by basic earnings per share.
accounting_metrics.revenue_growthRevenue growth against the comparable year-earlier period; a non-positive base returns null.
accounting_metrics.earnings_growthParent-profit growth against the comparable year-earlier period; a non-positive base returns null.
accounting_metrics.operating_income_growthOperating-income growth against the comparable year-earlier period; a non-positive base returns null.
accounting_metrics.ebitda_growthGrowth 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_growthBasic earnings-per-share growth against the comparable year-earlier period; a non-positive base returns null.
accounting_metrics.free_cash_flow_growthFree-cash-flow growth against the comparable year-earlier period; a non-positive base returns null.
accounting_metrics.book_value_growthParent-equity growth against the comparable year-earlier period; a non-positive base returns null.
accounting_metrics.earnings_per_shareReported basic earnings per share.
accounting_metrics.book_value_per_shareClosing parent equity divided by closing common shares outstanding.
accounting_metrics.free_cash_flow_per_sharePeriod free cash flow divided by basic weighted-average common shares.
next_offsetOffset of the next page; null on the last page
coverageobject
Show child attributes
reportsCandidate reports for this period and date bound, before filters; not a unique-company count
missing_nameCandidate reports missing a company name
missing_domicile_countryCandidate reports missing domicile_country
missing_sectorCandidate reports missing sector
missing_industryCandidate reports missing industry
unavailable_conversionReports passing text filters with an unavailable conversion for a requested, filtered or sorted value
matchedMatching reports before pagination; not a unique-company count
messageOnly 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.