Guide: trace a number to its filing

​

1. Resolve the company

curl "https://www.prometheus.services/api/v1/search?q=nvidia" \
  -H "X-API-KEY: $KEY"

​

2. Pull the statements

curl "https://www.prometheus.services/api/v1/companies/NVDA/financials?period_type=quarterly&limit=8" \
  -H "X-API-KEY: $KEY"

​

3. Trace the line

curl "https://www.prometheus.services/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"

{
  "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"
  }]
}

​

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.

​

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.
• 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.