> ## Documentation Index
> Fetch the complete documentation index at: https://doc.prometheus.services/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 Prometheus 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://www.prometheus.services/api/v1/search?q=nvidia" \
  -H "X-API-KEY: $KEY"
```

Take the ticker (`NVDA`) or, better, the CIK (`1045810`) — the CIK survives ticker
changes.

## 2. Pull the statements

```bash theme={null}
curl "https://www.prometheus.services/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 the line key (`revenue`) and the period end date of the
quarter you care about.

## 3. Trace the line

```bash theme={null}
curl "https://www.prometheus.services/api/v1/companies/NVDA/fact-source?statement=income_statement&key=revenue&end_date=2025-01-26&period_type=quarterly" \
  -H "X-API-KEY: $KEY"
```

The response carries:

* the **XBRL concept** the value was standardized from
* the **accession number** of the filing it was taken from
* the **calculation tree** the line participates in — how the statement ties

## 4. Cite it

> Q3 FY2025 revenue: \$35.08B — 10-Q `0001045810-24-000316`, period ending 2025-01-26,
> latest-restated basis.

That's the whole discipline. If you need what the company *originally* filed instead
of the latest restatement, add `reporting_basis=as_reported` in step 2.

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