Trace a number to the filing

Any standardized figure we serve can be followed all the way back to the exact fact in the exact SEC filing it came from. Here is the four-step path.

Why you can do this

We keep every filing’s facts exactly as filed and record which filing answered each request. So a served number is never a black box — it always has a traceable source.

1. Read the number — and note where it came from

Fetch the statements. In the response, meta.resolved_accession tells you the exact filing that answered you, and each line carries the company’s own concept tag (its QName).

step 1 · statements · bash

curl "https://api.finradar.ai/api/v1/xbrl/companies/AAPL/statements?period=Q" \
  -H "X-API-Key: YOUR_API_KEY"
# In the response, meta.resolved_accession names the filing that answered you,
# e.g. "0000320193-25-000123". Each statement line carries the company's own
# concept tag (a QName like us-gaap:Revenues).

2. Pull the as-filed facts for that concept

Ask the facts endpoint for that concept in that accession. You get the raw reported facts — value, period, units, and any segment breakdown — the evidence the standardized number was built from.

step 2 · facts · bash

curl "https://api.finradar.ai/api/v1/xbrl/facts?accession=0000320193-25-000123&concept=Revenues" \
  -H "X-API-Key: YOUR_API_KEY"
# You get every reported fact for that concept in that filing: the value, its
# period, its units, and any segment dimension — the raw as-filed evidence
# behind the standardized number.

3. See where it sits in the filing

The filing index shows the statements the filing contains and where the concept lives — confirming the fact’s place in the income statement, balance sheet, or cash-flow statement.

step 3 · filing index · bash

curl "https://api.finradar.ai/api/v1/xbrl/filing/0000320193-25-000123/index" \
  -H "X-API-Key: YOUR_API_KEY"
# The filing's role/statement inventory — which statements the filing contains
# and where the concept sits. From here the accession maps directly to the
# public SEC filing on EDGAR.

4. Open the source filing

The accession number (e.g. 0000320193-25-000123) is the filing’s public identifier on SEC EDGAR. You now hold an unbroken chain: served number → concept tag → as-filed fact → the original filing.

Bonus: check the math too

Request a rendered statement (template=true on the time-series endpoint) and each subtotal comes with a footing receipt proving it adds up — so you can verify not just where a number came from, but that the statement it sits in is internally consistent. See How the numbers are made.