---
title: "List Filings"
method: GET
path: "/filings/"
tags: ["Filings"]
---

# List Filings

`GET /filings/`

## Request

- Base URL: `https://api.financialreports.eu`
- URL: `https://api.financialreports.eu/filings/`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer

**Access Level Required:** Requires **Standard Access (Level 1)**.

---
Retrieve a paginated list of regulatory filings.

## Query parameters

- `added_to_platform_from` string, date-time
- `added_to_platform_to` string, date-time
- `categories` string
- `category` integer
- `company` integer
- `company_isin` string
- `countries` string
- `extensions` string
- `file_size_max` integer
- `file_size_min` integer
- `fiscal_period` '9M' | 'FY' | 'H1' | 'H2' | 'Q1' | 'Q2' | 'Q3' | 'Q4'
- `fiscal_year` integer
- `include_companions` boolean
- `include_predecessors` boolean
- `ingestion_mode` 'BACKFILLED' | 'REALTIME'
- `language` string
- `languages` string
- `lei` string
- `listing_status` 'DELISTED' | 'LISTED' | 'SUSPENDED' | 'UNKNOWN'
- `max_confidence` number, float
- `min_confidence` number, float
- `on_watchlist` boolean
- `ordering` string
- `page` integer
- `page_size` integer
- `period_ending_date` string
- `period_ending_date_from` string
- `period_ending_date_to` string
- `processing_status` 'COMPLETED' | 'FAILED' | 'PENDING' | 'PROCESSING' | 'QUEUED' | 'SKIPPED'
- `processing_statuses` string
- `reasoning_contains` string
- `release_datetime_from` string, date-time
- `release_datetime_to` string, date-time
- `search` string
- `source` number
- `source_filing_type` string
- `sources` string
- `type` string
- `types` string
- `updated_date_from` string, date-time
- `updated_date_to` string, date-time
- `view` 'full' | 'summary'

## Response `200`

Success. The response structure will be the full Filing object if `view=full` is used.

- PaginatedFilingSummaryList
  - `count` integer, required: Total matching results. Exact for cheap queries, an estimate on broad or expensive ones. Do not use it to decide when to stop: follow `next` until it is null.
  - `next` string, uri, nullable
  - `previous` string, uri, nullable
  - `results` FilingSummary[], required
    - `id` integer, required: Unique identifier for the filing.
    - `title` string: Optional title for the filing
    - `release_datetime` string, date-time, nullable: Time the document was published on the authority page
    - `document_url` string, uri, nullable, required: Direct link to our hosted copy of the original filing document or package (e.g. PDF/ZIP). Not signed and does not expire; anyone holding the link can download the file. Returns 404 if the filing is later removed or its document replaced.
    - `proxy_url` string, uri, nullable, required: Browser-renderable main document: for ZIP packages, a link that extracts and serves the main document; for every other format, the same link as the original document.
    - `viewer_url` string, uri, nullable, required: URL to view the filing in the interactive web platform.
    - `company` CompanyMinimal, required
      - `id` integer, required: Unique identifier for the company.
      - `name` string, required: Company name.
      - `tagline` string, required: A short, one-liner describing the company's value proposition.
      - `isins` string[], required: Primary ISIN(s) for the company. Use the company detail endpoint for the full list.
      - `lei` string, required: Legal Entity Identifier (ISO 17442).
      - `sub_industry_code` string, nullable, required: ISIC classification code classifying the company.
      - `oics_code` string, nullable, required: The company's primary OICS class code (public preview, OICS v0.3), e.g. `TC.SC.SEM.CHP`. Null when the company has no class under the current OICS version, including entity types that carry none (funds, shells, financing vehicles). The full label is the `oics` object on the full company representation.
      - `country_code` string, required: ISO 3166-1 alpha-2 country code of the company's primary registration or headquarters.
      - `date_public` string, date, nullable, required: Date this company record was last updated on the FinancialFilings platform. With `id`, it is the `date_public_cursor` of an incremental company sync.
    - `filing_type` FilingType, required
      - `id` integer, required: Unique identifier for the filing type. Filter filings with `?filing_type=<id>`.
      - `code` string, required: Unique code identifying the filing type.
      - `name` string, required: Human-readable name of the filing type.
      - `description` string, required: Detailed description of the filing type.
      - `category` FilingCategory, required
        - `id` integer, required: Unique identifier for the disclosure category.
        - `name` string, required: Name of the disclosure category.
        - `sort_order` integer, required: Order priority for display.
    - `processing_status` 'PENDING' | 'QUEUED' | 'PROCESSING' | 'COMPLETED' | 'FAILED' | 'SKIPPED': * `PENDING` - Pending * `QUEUED` - Queued * `PROCESSING` - Processing * `COMPLETED` - Completed * `FAILED` - Failed * `SKIPPED` - Skipped
    - `file_extension` string, nullable: File extension (e.g., PDF, HTML).
    - `file_size` integer, nullable: File size in bytes.
    - `ingestion_mode` 'REALTIME' | 'BACKFILLED', required: * `REALTIME` - Realtime * `BACKFILLED` - Backfilled
    - `source_url` string, uri, nullable, required: Original public link for this filing at the source authority. Null when unavailable, for anonymised sources, or when the account does not have source identities unlocked.
    - `source_filing_type` string, nullable, required: The source authority's own classification label, verbatim. Null when the source publishes no label, it was not captured, or the source is anonymised. Not gated on source identities.
    - `source_filing_id` string, nullable, required: The publisher's own identifier for this document, verbatim. Unique per source. On sources that publish one record per event and fan it out into one row per language and per attachment, the leading portion is a shared event stem, so rows of one disclosure sort together -- see the cross-language grouping recipe in the API docs. Null on legacy rows ingested before the identifier was retained.
  - `history_window` object, nullable: Present when the caller's plan applies a rolling history window AND this request reached past its cutoff. Absent for callers with unrestricted history. It means the PLAN bounds how far back this account can see — filings older than the cutoff exist in the FinancialFilings archive. It is never a statement about catalog coverage, and it does not by itself prove that this particular result set lost rows.
    - `limited` boolean
    - `max_history_days` integer
    - `cutoff` string, date-time
    - `detail` string

## Other responses

- `400`: Invalid query parameter, e.g. an unknown `types` code or a page beyond the limits.
- `401`: Unauthorized
- `403`: Missing or invalid API key, or the plan does not include this endpoint.
- `429`: Rate limit, plan quota or spend cap reached.

## Changes

- **2026-10-19** `a780251d6b05`: 1 info
  - added the new optional `query` request parameter `include_predecessors`

[Operation history](https://skmtc.dev/financialreports/apis/financialfilings-api/changes/filings/get.md)

---

[API](https://skmtc.dev/financialreports/apis/financialfilings-api.md) · [All operations](https://skmtc.dev/financialreports/apis/financialfilings-api/llms.txt) · [OpenAPI document](https://skmtc.dev/financialreports/apis/financialfilings-api/revisions/55935bdabd20?raw)