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 samemetric_key.
This Sits Beside the Statements, Not Instead of Them
Read value_is_change Before Using a Number
Whenvalue_is_change is true, the figure is a change, not a level: a release that says “revenue increased 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 carriesticker, 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 — readcoverage.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.