The decks
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 (negativeid,docRefset). 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
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
MCPget_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-revenuea deck-sourced block is labelled"… (investor presentation)", itssource.filingTypeis"Investor presentation (PDF)"andsource.sourceTagnames the exact slide:ir_deck:SAU-2280-20260331-DECK:p19. - In the
segments_kpisstatement of/financials, deck-sourced segment members appear as ordinaryseg::rows, and per-member KPIs appear askpimhdr::/kpim::rows headed"<KPI> by <Brand | Country | Product category | Channel | Segment> (investor presentation)". Scalar KPIs from decks are labelled"(presentation)". fact-sourceon any of those rows returnsprovenance: "segment_deck"and the deck’s document reference and page.