Use cases & endpoints
XBRL financials API — normalized company facts
XBRL was supposed to make filings machine-readable, and it did — in the sense that the machine can now read a thousand slightly different ways of saying revenue. Filers extend the standard taxonomy with custom tags, the same concept appears under different elements across companies, units and scaling vary, and the taxonomy itself changes between years.
The result is that anyone working with raw company facts spends more time on tag mapping than on analysis, and quietly accumulates a private dictionary that nobody else can reproduce.
Hindcast normalizes company facts onto a stable concept set, resolves units and signs, and keeps the original element name alongside the normalized one so nothing is lost and every mapping is auditable. Values carry the accession number they came from, which makes a surprising number is this right question resolvable in one click rather than one afternoon.
hindcast — session
previewhindcast> normalized operating income across several filers
→ tool: xbrl_facts { tickers:["..."], concept:"OperatingIncomeLoss", period:"..." }
✓ aligned values with original tags and units preserved
source: SEC XBRL company facts, per-filer taxonomy resolved
What's covered
- Company facts normalized onto a stable concept set
- Original element names retained beside the normalized concept
- Units, scaling and sign conventions resolved consistently
- Custom filer extensions mapped where defensible, flagged where not
- Accession number and filing date on every fact
- Taxonomy version changes handled without rewriting older facts
Join the waitlist — this page's dataset is already selected.
Questions
What happens to custom extension tags?
They are mapped to the standard concept when the mapping is defensible and surfaced as-is when it is not. A wrong mapping is worse than an unmapped value, so ambiguity is exposed rather than guessed.
Can I still see the raw filing values?
Always. The normalized concept is a convenience layer over the original fact, never a replacement, and both travel together in the response.
Related
Join the waitlist. Vote the roadmap. First in, first served.