Plan: Free and above · Credits: 1 per call
What you can use US presentation decks for
Read the charts and KPIs management chose to show on a results call, next to what they said on it. Follow how a company pitches itself at broker conferences between earnings. Compare an investor-day deck with the targets in the company’s later guidance. Pull the financial supplement a company posts with its results instead of rebuilding its tables.What is and is not a deck
A document is served here only when its text reads as a deck — the event title alone cannot tell, because one “Q2 Earnings Conference Call” page may carry the slides, the earnings release, the call notice and SEC filings together. Only the slides and the financial supplement are returned; releases, notices, transcripts and filings posted on the same page are not. The typing is not perfect: an audit of 60 rows found 51 real decks or supplements, with the rest being results tables, press releases, prepared remarks or a filing that passed the text rules.classifier_version on each row says which rule set typed it.
US presentation deck coverage
Coverage is a fixed set of about 1,470 US companies whose investor-relations websites are read continuously — not the whole market. The response’scoverage.companies_covered gives the current count. History is as deep as each site’s own archive; coverage.available_from and available_to give the range for the company you asked about.
The endpoint covers US companies only. A non-US company returns 404; for other markets see Global Exchange Disclosures.
Key US presentation deck fields
event_titleandevent_id— the event the document was posted under;page_urlis the page it was found on andurlis the file itself. The same file can be posted under more than one event page, so two rows can share oneurl.call_type— what kind of event the document came from, read from the event title:earnings(results calls),conference(broker conferences, fireside chats, investor days and analyst meetings) orother(a bare “Investor Presentation”, deal or partnership calls).subtype—slides(the presentation) orfinancial_supplement(supplemental tables or a fact book).format— the file format, such aspdf.charsis the length of the extracted text.textandtext_truncated— present only when you passinclude_text=true.
counts block: matched for your filters, in_this_tool for all of this company’s decks, and by_subtype / by_call_type breakdowns, so you can see what exists before filtering.
US presentation deck date convention
Dates are the event’s, as the website wrote them, and only a real calendar day becomesdate. date_status says what the site gave:
date_as_written keeps the original. Rows are returned newest first: dated rows, then rows with only a period_label, then undated rows.
date_gte and date_lte apply to date only. Rows without one are dropped from a ranged answer and counted in counts.undated_excluded_by_date_filter, so a ranged result never silently means “of the dated ones”.
US presentation deck text
Passinclude_text=true to add the extracted text of each deck, capped at max_chars per row. Text is extracted from the PDF, so slides read as fragments and tables lose their layout: quote it, but take reported figures from the financial statements or reported earnings figures.
When a result looks short
counts.pending_classificationgreater than zero means some of this company’s documents were just found and are not typed yet; they appear once typed.counts.truncated_at_source: truemeans the company’s archive was larger than one read returns.- A date range drops undated rows — check
counts.undated_excluded_by_date_filter.
GET /v1/companies/{company}/us/ir-presentation-decks
string
required
Ticker (
META), company_id (cmp_…), CIK or ISIN of a US company.string
earnings, conference or other. Omit for all.string
slides or financial_supplement. Any other value returns 400.string
Case-insensitive substring of the event title, e.g.
investor day.string
Earliest event date,
YYYY-MM-DD; date_lte sets the ceiling. Undated rows are excluded and counted.string
default:"false"
true adds each deck’s extracted text.integer
default:"20000"
Text cap per row when
include_text=true, between 1,000 and 200,000.integer
default:"50"
Rows per page, between 1 and 200. Defaults to 10 when
include_text=true. Page through with cursor, passing back next_cursor unchanged.