A plain-language overview of how secapi.dev maps as-reported XBRL into comparable canonical metrics — the same layer behind /v1/financials/metrics and standardized statement endpoints.
Last updated: July 7, 2026
Every standardized number begins with the filing the company actually submitted to the SEC. We ingest 10-K and 10-Q XBRL presentation and calculation linkbases, preserving accession numbers, form type, period end dates, and the original tag names.
Companies rarely use the same XBRL tag for the same economic concept. Our canonical layer maps 200+ common as-reported tags into one storage key per metric (for example revenue, net_income_loss, total_assets) so screeners and models can compare issuers without hand-maintained tag tables.
Standardized endpoints are the fast path for analytics. As-reported statement grids remain available per accession for auditors and quants who need the exact presentation the filer used.
Canonical series include fiscal year, form, period end, unit, source tag, and mapping confidence. That makes it straightforward to trace any value back to a specific SEC filing rather than treating the API as a black box.
Canonical metrics return the mapped symbol, the original SEC tag, and a mapping confidence score so you can audit every number:
curl -G "https://api.secapi.dev/v1/financials/metrics" \
-H "x-api-key: $SECAPI_API_KEY" \
--data-urlencode "ticker=AAPL" \
--data-urlencode "symbols=revenue,net_income_loss" \
--data-urlencode "qtrs=4"See also: Financials API reference and the public status page.