Skip to main content
Company Measures are the company-level figures a company printed in its earnings release, with the question of which row on the page is the company’s own figure already settled. Each observation is one figure for one period from one release, carrying the value, the verbatim quote it was read from and the link to the release. Use it when you want “what did the company report for X” without reasoning about which of several rows is the consolidated one.
Plan: Free and above · Credits: 1 per call

What You Can Use Company Measures For

Read the measures a company manages to — adjusted EBITDA, organic growth, net interest margin, same-store sales, production volumes, backlog — which the financial statements have no column for. See what the headline figures looked like on the day, before any restatement. Compare a reported figure with management guidance on the same metric_key.

This Sits Beside the Statements, Not Instead of Them

Income Statements and their siblings are the audited, comparable, restated record. This dataset is the figure as printed on the day.Where the two overlap they can legitimately differ. FAST’s EPS reads 0.52 here and 0.26 in the statements — a stock split restated the statement, while this dataset keeps what the market read that morning. Both are right. Cite this dataset for “what was announced” and the statements for “what is comparable”.

Read value_is_change Before Using a Number

When value_is_change is true, the figure is a change, not a level: a release that says “revenue increased 50million"stores50,000,000,whichlooksexactlylike"revenuewas50 million" stores 50,000,000, which looks exactly like "revenue was 50 million” without the flag. unit_check flags a row whose key says money and whose unit says count. It is a flag, never a correction.

GAAP and Non-GAAP Readings Are Separate Rows

basis separates a GAAP reading of a metric from a non-GAAP one; the two are separate rows.

One Consolidated Reading per Figure

Only the company-level reading is served: row_level is company_total or sole. The segment, product and geography breakouts beneath these totals are in Segment Breakouts from Earnings Releases. Rows whose identity could not be decided are in neither, and appear only in Reported Earnings Figures.

Key Company Measure Fields

Each row carries ticker, company_id, the fiscal year and quarter of the release, observed_at (the release timestamp, which also orders the rows) and occurred_on, doc_id and source_ref (the release), metric_key and metric_key_as_extracted, basis, period as the release labelled it with period_grain, period_calendar and period_end, the printed label and value_text, the parsed value_low and value_high (equal unless value_is_band), value_unit, yoy when the release printed one, quote, value_is_change, unit_check and row_level. metric_key is normalised — research and development expense arrives under many spellings and is one key here. metric_key_as_extracted is what the release actually said, and filtering on either works.

Company Measures Coverage

Companies whose earnings releases are covered: SEC 8-K and 6-K filings, Japanese and Hong Kong exchange announcements, A-share filings and company IR pages. The floor moves as the backfill proceeds — read coverage.available_from on the response.

Company Measures Date Convention

year and quarter are the fiscal year and quarter of the release. period is the period the figure is for, as the release labelled it — a Q3 release can also print year-to-date figures. Rows are returned newest release first.

GET /v1/companies/{company_id}/8k-company-measures

Company-level figures from one company’s earnings releases, newest first. The identifier is expanded to every ticker the company is known by.
string
required
A ticker, company_id, CIK or ISIN.
string
Normalised metric, for example revenue, adjusted_ebitda or eps. The pre-normalisation spelling is accepted too.
string
The period the figure is for, exactly as the release labelled it, for example Q3-FY26.
integer
Fiscal year of the release.
integer
Fiscal quarter of the release, 1 to 4.
integer
default:"100"
Rows per page, between 1 and 1000. Page through with cursor.
See also Segment Breakouts from Earnings Releases for the breakouts beneath these totals, Reported Earnings Figures for every row the release contained, Management Guidance for the forward-looking half of the same vocabulary, 8-K Exhibits for the release text, and Income Statements for the restated record.