metric_key vocabulary with Management Guidance, so “what did they guide revenue to” and “what did revenue come in at” are one key and two calls.
Plan: Fund · Credits: 1 per call
What You Can Use Reported Earnings Figures For
Compare a guided figure against the delivered one on the same key. Read the non-GAAP lines companies actually guide on — adjusted EBITDA, organic growth, segment KPIs, subscriber counts. Build a KPI history that XBRL cannot supply. Pair a number with management’s explanation of it.Why This Is Not a Substitute for the Financial Statements
Every Figure Keeps Its Quote
Every row keeps thequote it was read from, and a figure that could not be found verbatim in the filed text is dropped rather than stored.
A reader treats “revenue was $190.2 million” as a fact, so a guessed one is worse here than a missing one.
Why Year-Over-Year Can Be Null
yoy is the change the release printed, and it is null when the release printed none. It is never computed.
The basis of a year-over-year figure — adjusted, constant-currency, pro forma — is the filer’s to state. A number FocusAlpha divided would look identical on the page while carrying none of that meaning.
Do Not Sum a Page Without Setting level
basis separates a GAAP from a non-GAAP reading of the same metric, which a release routinely prints side by side.
Reported Earnings Figures Date Convention
observed_at is when the document went out. occurred_on is the filing’s own Period of Report.
year and quarter are the fiscal year and quarter of the release. period is the period the figure is for, as the release printed it — for example Q2 2026.
Reported Earnings Figures Coverage
Read thecoverage block in the response. The floor moves as the backfill proceeds, so no date written on this page would stay true.
Reported Earnings Figures Sources
Figures are read from the company’s own 8-K earnings release. They are as printed: not restated, not recomputed, and dropped rather than guessed when they could not be verified in the filed text.Query Reported Earnings Figures
Use the earnings results endpoint for one company.string
required
A
company_id, ticker, CIK or ISIN.string
Normalised metric, for example
revenue, adjusted_ebitda, eps.string
The period the figure is for, as printed, for example
Q2 2026.integer
Fiscal year of the release.
quarter narrows to one fiscal quarter, 1 to 4.string
consolidated or segment. Omit for both — but choose one before summing.integer
default:"100"
Rows per page, between 1 and 1000. Page through with
cursor.