Docs/Reference/Coverage/Get Coverage
GET/v1/coverageTier · Free

Get Coverage

How much of the universe is covered, broken down by metric.

For each financial field, returns the percentage of companies with a non-null value at the latest filing year. Use this to:

- Pick which metrics to filter or screen on (high-coverage fields give bigger samples). - Spot fields that look attractive but only ~30% populated (e.g. capex, segment revenue) before building dashboards. - Track parser improvements over time as coverage rises.

Read alongside /freshness to know how recent the data is and /ontology/fields/{name}.null_reasons to know why specific fields are null for some filers.

Request headers · 1

Authentication.

Authorizationstringrequired

Production API key. Pass it as Bearer ax_live_…

Returns · 200

The standard { data, meta } envelope. data contains CoverageOut.

Envelope

dataCoverageOut

A single result object.

metaMeta

Pagination and request metadata, including request_id, data_as_of, and ontology_version.

ontology_version 2.1.0replay meta.as_of · ?as_of=<token>

CoverageOut

totalsCoverageTotals

High-level coverage counts.

fiscal_year_rangeFiscalYearRange

Earliest and latest fiscal years available.

fiscal_year_depthFiscalYearDepth[]

Per-year breakdown of companies and filings.

latest_filing_atstring | null

Timestamp of the most recent filing (ISO 8601).

metric_coverageobject

Coverage percentage for each financial metric.

accounting_standardsobject

Count of filings per accounting standard.

sector_breakdownSectorBreakdown[]

Company count by sector.

exchange_breakdownExchangeBreakdown[]

Company count by TSE market segment.

filing_typesFilingTypeBreakdown[]

Filing count by document type.

data_sourceDataSourceInfo

Information about the upstream data source.

Errors

Standard HTTP status codes plus a typed error.code in the { error: { code, message } } envelope.

Every endpoint returns the same typed error envelope ({ error: { code, message } }). For the full list of codes, see the Errors reference.