Skip to main content
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

Newest first. from and to bound dates; limit and offset bound a request. Keep the response’s paging metadata and source references when continuing:
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.
fiscalYear and fiscalQuarter name the period the deck covers; both are null when it is not known, and a conference or investor-day deck has none. A year with a null quarter is the full-year deck. A period is set only when its evidence agrees: an 8-K deck takes the period its own filing announces (“reported second quarter 2025 earnings”), checked against the company’s earnings call that week; an exchange-lane deck carries the period its source publishes it under, and a year-only deck takes a quarter only from the call it was posted after, in the same fiscal year. title is the title to show. When the stored title is only link text or a placeholder (“View Presentation”, “Investor Presentation for 2”, ”… Presentation — 2025-01-22”), title is rebuilt from the period (“Q2 2026 Investor Presentation”), the event the 8-K names (“Barclays Global Consumer Conference”), a readable file name, or else the filing date. sourceTitle is the title exactly as stored. 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

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

MCP get_presentations lists decks and their pages using bounded requests. Use get_document_text to read a PDF when text or stored OCR is held; image-only pages remain images. /companies/{id}/presentation-guidance exposes source-linked guidance observations extracted from presentations. Keep document and page anchors when citing a statement; an extracted promise is not an observed outcome. 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 for the row vocabulary.