Documents

All our documents, such as slide decks and reports, are organized around events. To retrieve all documents related to a specific event, we recommend using the event documents endpoint. The various types of documents can be found in the document types endpoint, which provides a list of document types along with a short description and any available formal form types. When indexing the document types, use the id field as the string values could be changed.

Single pages

To fetch a single page from any given document, use the document page endpoint. This endpoint allows you to retrieve a page in both PNG and PDF formats.

Documents as part of event responses

The API often retrieves events with attached documents, such as reports and slide decks presented during the event. Displaying these materials alongside the audio improves users understanding of the content.

Webhooks

To make sure you always have the latest documents, we recommend you subscribe to the documentCreated webhook, which is sent out any time a new document is added, or an existing document is updated.

More info on this in the Documents section in the Getting Updates page.

Slide Decks and Reports

Presentation materials, such as slide decks, can be accessed through the pdfUrl, reportUrl and slidePreviewUrl variable in event responses. It is important to note that these slide decks often feature transparent backgrounds, and to optimize readability, it is recommended to embed them over a white background. For applications with a dark mode, developers should consider implementing an appropriate solution to address this display issue. Additionally, we cannot guarantee optimal readability for all slide decks over white backgrounds, as some may contain transparent backgrounds and light-colored text. The appearance of each slide deck may vary.