> ## Documentation Index
> Fetch the complete documentation index at: https://quartr.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Filings and reports

> Historical filings and reports from companies

<img
  src="https://mintcdn.com/quartr/uS9un6ABvG4dvudU/images/filings_and_reports.webp?fit=max&auto=format&n=uS9un6ABvG4dvudU&q=85&s=5b5af419a507b86cc5075e5619fbb095"
  alt="Descriptive alt text"
  noZoom
  style={{
width: '100%',
height: 'auto',
borderRadius: '8px',
marginBottom: '1rem',
}}
  width="1920"
  height="1080"
  data-path="images/filings_and_reports.webp"
/>

## Overview

The filings and reports dataset provides access to regular annual and quarterly earnings reports, 10-Ks and 10-Qs, 8-K 99.1, and unique events like conferences, capital market days, annual general meetings, and M\&A announcements. Each report is associated with a company and updated in the dataset when available.

## How it works

The reports are provided in **PDF** format, which is widely supported by most devices and operating systems. The data is sourced from a variety of public sources, such as company websites, regulatory filings, and news outlets. The reports are processed and indexed to ensure easy retrieval and access.

## How to access this data

<CardGroup cols={3}>
  <Card title="REST API" icon="code" href="/api-reference/reports">
    Query with filtering by ticker, ISIN, date, and more.
  </Card>

  <Card title="Webhooks" icon="webhook" href="/webhooks/getting-started">
    Subscribe to report.created events for real-time updates.
  </Card>

  <Card title="Snowflake" icon="snowflake" href="/snowflake/getting-started">
    Query the reports view directly via SQL.
  </Card>
</CardGroup>

## Types and groups

There are two main ways to categorize reports: by type and by group. For most users, the groups are sufficient for filtering reports.

<AccordionGroup>
  <Accordion title="Document groups">
    There are four groups of reports:

    1. **Earnings release**
    2. **Press release**
    3. **Interim report**
    4. **Annual report**
    5. **Proxy filing**
    6. **Registration filing**

    The earnings releases are technically a subset of press releases, but they have been separated since the use cases for the two are usually very different. The interim reports are usually either quarterly or semi-annual reports, while the annual reports are yearly reports.

    In some countries, such as the US, the annual reports are also known as 10-K filings. These replace the quarterly 10-Q filings for last quarter of the fiscal year. The API allows you to specify multiple values and capture all reports that match any of the specified groups.

    The integer values for the groups are used in the API requests to filter the reports. For example, to retrieve all annual reports, you would use the `documentGroupIds` query parameter with a value of `4`.
  </Accordion>

  <Accordion title="Document types">
    Document types are more granular than groups and are used to filter reports by specific types. The groups are effectively a higher level grouping of the types. Since we constantly add new types, we recommend using the groups for most use cases.

    The types include, but are not limited to: **8-K**, **10-Q** and **10-K**.

    The types are used in the API requests to filter the reports. For example, to retrieve all 10-K reports, you would use the `typeIds` query parameter with a value of `11`.
  </Accordion>
</AccordionGroup>

<Info>
  The type IDs are not sequential and may change over time as new types are added. Always refer to the [document types endpoint](/api-reference/document-types/list-document-types) for the most up-to-date list of types and their corresponding IDs.
</Info>
