Retrieve a slide deck

Returns the slide deck that management presents during an earnings call, sometimes called a results presentation or investor presentation.

The response includes file metadata and a signed url on content.roic.ai. You can download the file directly without API credentials. The link expires at expires_at, one hour after your request. Call the endpoint again to get a new link.

Take the doc_ id from the slides array of the call listing. Filings share the doc_ prefix, so a filing id on this route returns 404. Slide decks require a Professional or Enterprise plan.

GET/v3.0.0/documents/slides/{id}

Plan Access

Free

(Your plan)

Individual

$29/mo

Professional

$89/mo

Plan History

Free

(Your plan)

Not included

Individual

$29/mo

Not included

Professional

$89/mo

All available

Request
curl "https://api.roic.ai/v3.0.0/documents/slides/doc_WsxLPhz7rjNQnq?apikey=YOUR_API_KEY"
Response
200 OK
{
  "id": "doc_WsxLPhz7rjNQnq",
  "event": "evt_hbBlbCUawzMoz0",
  "symbol": "NASDAQ:AAPL",
  "fiscal_year": 2026,
  "fiscal_quarter": 3,
  "period_end_date": "2026-06-30",
  "filename": "NASDAQ-AAPL_presentation_2026-06-30_FY2026-Q3_doc_WsxLPhz7rjNQnq.pdf",
  "url": "https://content.roic.ai/slides/file_QnRvMLc8ZgsE3W.pdf?filename=NASDAQ-AAPL_presentation_2026-06-30_FY2026-Q3_doc_WsxLPhz7rjNQnq.pdf&verify=1758031446-<mac>",
  "expires_at": "2026-09-16T14:04:06.755Z",
  "document_group": "presentation",
  "document_kind": "presentation",
  "language": "en",
  "created_at": "2026-07-30T21:10:12.004Z",
  "updated_at": "2026-08-01T04:22:31.884Z"
}

Parameters

Path parameters

idstringrequired

The document id from the slides array of the event listing, beginning with doc_. A filing id on this route returns 404.

Example: doc_WsxLPhz7rjNQnq

Response

Response fields

idstring

Unique identifier for the file. doc_ for a slide deck or a filing.

eventstring

Identifier of the parent event, beginning with evt_.

symbolstring

Qualified symbol combining the exchange code and ticker separated by a colon, e.g. NASDAQ:AAPL. It names the primary listing of the event.

fiscal_yearnumber

Fiscal year the event reports on, e.g. 2026. The fiscal year is the calendar year in which it ends. null when the period is not known.

fiscal_quarternumber

Fiscal quarter the event reports on, from 1 to 4. null for an annual period and when the quarter is not known. If the company reports semiannually, the first half is 2 and the second half is 4.

period_end_datestring

Last day of the reporting period, in YYYY-MM-DD format.

filenamestring

Download name of the file. The fiscal label appears only when the period is certain, and the language code only when the file is not in English.

urlstring

Signed download link on content.roic.ai. Fetch it directly, without API credentials, and send it exactly as returned.

expires_atstring

ISO 8601 timestamp after which url stops working, one hour after the request by default. Call the route again for a new link.

document_groupstring

Always presentation for a slide deck.

document_kindstring

Always presentation for a slide deck.

languagestring

Two-letter language code of the file, e.g. en. null when it is not known.

created_atstring

ISO 8601 UTC timestamp of when this file was first stored.

updated_atstring

ISO 8601 UTC timestamp of when this file last changed.

Errors

StatuscodeWhen it happens
400invalid_parameterA malformed id.
402document_restrictedThe key is below the Professional plan.
404resource_missingNo slide deck with that id, including a filing id.