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

# Investor presentations

> Every deck an issuer has filed or published, page by page — and the numbers read from them, cited to the slide.

Investor presentations come from two places: the slide decks US filers furnish as 8-K
Item 7.01 exhibits, and the results decks that exchange-lane issuers — Tadawul, DFM, ADX and
others — publish alongside their financial statements. Astreus stores them, renders
them, and where a deck discloses segment or KPI figures the statements do not, reads those
figures under the same gates as everything else.

## The decks

```
GET /api/v1/companies/{id}/presentations
```

Unpaginated, newest first — issuers publish a handful of decks a year:

```json theme={null}
{
  "presentations": [
    {
      "id": 408,
      "title": "Earnings Presentation Q2 2026",
      "filingType": "PRES",
      "filingDate": "2026-07-06",
      "accessionNumber": "SAU-2280-20260706-DECK",
      "itemCodes": [],
      "exhibitType": "IR-DECK",
      "pageCount": 40,
      "totalBytes": 6526267,
      "cik": "XSAU000001",
      "format": "slides",
      "docRef": null
    },
    {
      "id": -67622,
      "title": "Earnings presentation FY2025",
      "filingType": "PRES",
      "filingDate": "2026-03-31",
      "accessionNumber": "SAU-2280-20260331-DECK",
      "exhibitType": "PDF",
      "pageCount": 39,
      "cik": "XSAU000001",
      "format": "pdf",
      "docRef": "SAU-2280-20260331-DECK"
    }
  ]
}
```

`format` tells you how to open it:

* `slides` — the deck has been rasterised, one image per slide. Fetch pages with the route
  below. This covers 8-K exhibits and the exchange-lane decks the pipeline has rendered.
* `pdf` — the stored PDF itself (negative `id`, `docRef` set). Open it whole through the
  filings document route, `GET /companies/{id}/filings/{docRef}`, exactly as the terminal's
  Documents tab does.

For an 8-K exhibit `accessionNumber` is the SEC accession, `filingType` is `8-K`,
`itemCodes` lists the items (`["7.01"]`) and `exhibitType` is the exhibit number
(`EX-99.2`). `cik` is the filer — a predecessor entity may have filed the deck.

## Pages

```
GET /api/v1/companies/{id}/presentations/{presentationId}/pages/{page}
```

Streams one slide image (`page` is 1-based, up to 500). The route is **public** — the
images are meant for `<img src>` — and immutable once rendered, so cache freely. Only
`format: "slides"` decks have pages.

## Numbers read from decks

A deck is a display document, not a source for the statements: nothing in a presentation
ever alters `/financials`' income statement, balance sheet or cash flow. But issuers do
disclose in decks what they omit from the statements — revenue by product or brand,
like-for-like growth, share of revenue by channel, margin by segment — and those figures are
extracted, gated and served with their provenance:

* In `GET /companies/{id}/segment-revenue` a deck-sourced block is labelled
  `"… (investor presentation)"`, its `source.filingType` is `"Investor presentation (PDF)"`
  and `source.sourceTag` names the exact slide: `ir_deck:SAU-2280-20260331-DECK:p19`.
* In the `segments_kpis` statement of `/financials`, deck-sourced segment members appear
  as ordinary `seg::` rows, and per-member KPIs appear as `kpimhdr::`/`kpim::` rows headed
  `"<KPI> by <Brand | Country | Product category | Channel | Segment> (investor
  presentation)"`. Scalar KPIs from decks are labelled `"(presentation)"`.
* `fact-source` on any of those rows returns `provenance: "segment_deck"` and the deck's
  document reference and page.

Every deck-derived number ties to something the statements already serve before it is
shown — a revenue split must reconcile to consolidated revenue, a ratio must land in a
period column that exists — so the deck adds detail without adding a second, unreconciled
version of the company.

See [Segments & KPIs](/segments-and-kpis) for the row vocabulary.