> ## Documentation Index
> Fetch the complete documentation index at: https://doc.astreus.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Guide: trace a number to its filing

> From a revenue figure to the exact XBRL fact and accession, in three calls.

The workflow that makes Astreus different: never quote a number you can't cite.
This guide traces NVIDIA's quarterly revenue to its source filing.

## 1. Resolve the company

```bash theme={null}
curl "https://astreus.ai/api/v1/search?q=nvidia" \
  -H "X-API-KEY: $KEY"
```

Take the ticker (`NVDA`) or, better, the CIK (`1045810`) — the CIK survives ticker
changes. For a non-US issuer take the platform key the payload returns as `cik`
(`XSAU000001`), which is the only unambiguous handle. See [Coverage](/coverage).

## 2. Pull the statements

```bash theme={null}
curl "https://astreus.ai/api/v1/companies/NVDA/financials?period_type=quarterly&limit=8" \
  -H "X-API-KEY: $KEY"
```

One call returns the standardized income statement, balance sheet and cash flow for up to
200 periods. Note two things about the cell you want: its **row key** (`std:revenue`) and
its column's **period end** — `period_meta["Q3 2025"].end_date` is `2024-10-27`.

## 3. Trace the line

```bash theme={null}
curl "https://astreus.ai/api/v1/companies/NVDA/fact-source?statement=income_statement&key=std:revenue&end_date=2024-10-27&period_type=quarterly" \
  -H "X-API-KEY: $KEY"
```

```json theme={null}
{
  "provenance": "filed",
  "std_value": 35082000000,
  "source_tags": ["us-gaap:Revenues"],
  "filing": {
    "accession_number": "0001045810-25-000230",
    "filing_type": "10-Q",
    "filing_date": "2025-11-19",
    "fiscal_year": 2026,
    "fiscal_quarter": 3,
    "period_end_date": "2025-10-26"
  },
  "facts": [{
    "tag_name": "us-gaap:Revenues",
    "context_id": "c-4",
    "raw_value": 35082000000,
    "unit": "iso4217:USD",
    "decimals": -6,
    "start_date": "2024-07-29",
    "end_date": "2024-10-27"
  }]
}
```

The response carries the **XBRL concept** the value was standardized from, the
**accession number** of the filing it was read from, and the **raw fact** with its context,
unit and precision. Notice the filing: the value for the quarter ended 2024-10-27 comes from
the 10-Q filed on 2025-11-19 — the following year's Q3 report, whose comparative column is
the latest restated statement of that quarter. That is the default vintage, and it is what
the citation must say.

## 4. Cite it

> Q3 FY2025 revenue: \$35.08B — us-gaap:Revenues, 10-Q `0001045810-25-000230` (filed
> 2025-11-19), quarter ended 2024-10-27, latest-restated basis.

That's the whole discipline.

## Variations

* **A derived quarter.** Ask for `end_date=2025-01-26` (NVIDIA's Q4 FY2025) and
  `provenance` is `derived_q4`, with `composition` showing FY − Q1 − Q2 − Q3 and each input
  cell you can trace in turn.
* **What the company originally filed.** Pull the same statement with
  `GET /companies/NVDA/financials/as-filed?statement=income_statement&period_type=quarterly&vintage=original`
  — each period from the filing the company made for it, cell by cell with its `docRef`.
* **A segment or KPI.** The row keys in `financials.segments_kpis.data` (`seg::…`,
  `kpi::…`) are `fact-source` keys too, with `statement=segments_kpis`. See
  [Segments & KPIs](/segments-and-kpis).
* **A non-US issuer.** For Almarai (`XSAU000001`) the same call returns the PDF statement's
  page and printed text in place of an XBRL context, and `filing.document_ref` in place of an
  accession.

<Tip>
  Building an agent? [skill.md](https://astreus.ai/skill.md) encodes this
  exact loop as a playbook, and every rule in
  [agents.md](https://astreus.ai/agents.md) assumes it.
</Tip>