What XBRL adds to a filing
XBRL attaches structured labels and contexts to reported financial facts. The SEC's company-facts API organizes company facts by taxonomy and tag, then reports units and observations with period and filing metadata. That makes some values easier to retrieve and compare than reading every filing table manually.
A tag is not a universal guarantee that two numbers mean exactly the same thing. Taxonomy, label, unit, context, duration, and issuer-specific reporting all matter. Companies can use custom tags for concepts not represented by standard taxonomy elements; a standardized data product may not map every custom fact.
Read the period and unit before comparing
A duration fact covers an interval, such as revenue for a fiscal year or quarter. An instant fact describes a point in time, such as assets at the period end. A value reported in USD is not comparable to a per-share value or a value reported in shares. Compare period start/end, form, unit, and source accession alongside the numeric value.
Calendar-year frames can select an issuer's closest fiscal period rather than a period ending December 31. Use the returned periodEnd when comparing companies with different fiscal calendars.
Annual, quarterly, and trailing-twelve-month data
Annual and reported-quarterly observations come from filed data; they are not forecasts. TTM flow metrics can be constructed from the latest fiscal year plus current year-to-date less the comparable prior-year year-to-date period. Point-in-time balance-sheet metrics use the latest available instant. A TTM result should therefore be read with its method and component periods.
Some companies do not file a standalone fourth-quarter 10-Q; the fourth quarter is reflected in the annual filing and may be calculated from annual and interim values. Do not treat a missing quarterly fact as zero.
Why values may be missing or later change
A mapped metric can be absent because the issuer used a different tag, a custom taxonomy concept, a different presentation, or did not report the fact for that period. Missing is not zero. A later filing may show a changed comparative because of an amendment, reclassification, or updated disclosure. A difference by itself does not establish a formal restatement.
When a value matters, follow its source accession to the filing, inspect the taxonomy tag and unit, and compare the exact period. EdgarStack keeps selected XBRL tags and filing references with outputs where available; coverage depends on the issuer's reported facts.
A repeatable review
First resolve the ticker to a CIK. Retrieve the metric and requested period. Check units and period ends; then inspect provenance or data-quality coverage. For cross-company comparisons, align actual period ends and use metrics available for each issuer. Treat ratios and growth rates as calculations over reported inputs, not as SEC-published conclusions.
Official sources
Use these SEC resources to confirm filing requirements, API behavior, and company-reported facts.