List Filings

Filter by date added to platform (inclusive start date, YYYY-MM-DDTHH:MM:SSZ format).

Filter by date added to platform (inclusive end date, YYYY-MM-DDTHH:MM:SSZ format).

Filter by multiple Filing Category IDs. Comma-separated (e.g., 1,3).

Filter by a single Filing Category ID.

Filter by internal Company ID.

Filter by Company ISIN. Case-insensitive.

Filter by Company country ISO Alpha-2 code(s). Comma-separated for multiple values (e.g., US,GB,DE).

Filter by file extension(s). Single (e.g., PDF) or comma-separated (e.g., PDF,XBRL). Case-insensitive.

Filter by maximum file size in bytes.

Filter by minimum file size in bytes.

Filter by fiscal period. Possible values: FY (Full Year), Q1, Q2, Q3, Q4, H1 (First Half), H2 (Second Half). Only populated for filing types: 10-K, 10-K-ESEF, IR, ER.

Filter by fiscal year (e.g., 2024). Only populated for filing types: 10-K, 10-K-ESEF, IR, ER.

Include companion data files in type and category filters. Companions are small machine-readable XBRL/XML/JSON files stored beside a report for financial extraction, typed like that report. Most are not converted to markdown and show processing_status SKIPPED; the report beside them carries the text. Default false: type, types, category and categories return the reports only.

With company, also return the filings of the company's predecessors: the issuers it succeeded by reorganisation or redomicile (its predecessors of kind reorganization or other on GET /companies/{id}/, followed back through the chain; merged-in targets and spin-off parents are not included), each up to and including the link's effective date (UTC). Each filing's company is still the issuer that filed it. Default false. Requires company; lei and company_isin do not follow predecessors.

Filter by ingestion mode. Whether the filing was added to the platform promptly after publication. REALTIME: added within the source's normal publication delay (5 to 48 hours after release_datetime, depending on the source). BACKFILLED: everything else, including historical imports and new filings that reached the platform late, for example after a source outage. Set once when the filing is added and not recalculated afterwards.

Filter by a single filing language ISO 639-1 code (e.g., en).

Filter by filing language ISO 639-1 code(s). Comma-separated for multiple values (e.g., en,de).

Filter by Company Legal Entity Identifier (LEI).

Filter by the issuing company's listing status, e.g. LISTED for listed firms only. This is the company's status today, not at the time of the filing. Exact, case-sensitive match; an unknown value returns 400.

Maximum classifier confidence for the assigned filing type (0.0-1.0).

Minimum classifier confidence for the assigned filing type (0.0-1.0).

Filter by companies on the user's watchlist. Use 'true' to see only watchlist companies, 'false' to exclude them. Omitting the parameter returns all companies.

Which field to use when ordering the results. Available fields: id, release_datetime, added_to_platform, filing_type_confidence. Prefix with '-' for descending order (e.g., -release_datetime). Rows that tie on the chosen field are ordered by id in the same direction, so paging through results with next does not repeat or skip a filing as long as the matching filings do not change while you page. NOTE: -filing_type_confidence lists filings with NO confidence score (NULL, over a quarter of the corpus) FIRST, because descending sorts place NULLs first. To rank scored filings most-confident-first, combine it with min_confidence=0, which excludes unscored ones.

A page number within the paginated result set.

Number of results to return per page.

Filter by the exact period ending date (YYYY-MM-DD, e.g., 2024-12-31). Only populated for filing types: 10-K, 10-K-ESEF, IR, ER.

Filter by period ending date — inclusive start (YYYY-MM-DD).

Filter by period ending date — inclusive end (YYYY-MM-DD).

Filter by processing status. COMPLETED means the document has been processed and is ready to download; the other values are still in, or dropped out of, the processing pipeline. Exact, case-sensitive match; an unknown value returns 400.

Comma-separated processing statuses (e.g. COMPLETED,FAILED). Case-insensitive. An unknown value returns 400 naming it.

Case-insensitive substring match on filing_type_reasoning, minimum 3 characters. Requires at least one other filter that actually constrains the query (a date range, company/ISIN/LEI, type, category or source), otherwise returns 400 — the field is unindexed. NOTE the guard checks that a companion filter constrains the query, not HOW MUCH: a deliberately wide date range is accepted and the request is then bounded by the API statement timeout rather than rejected. Narrow the companion filter for a fast answer. CAVEAT: this text is evidence of what the model looked at, NOT a statement of our classification policy; it can cite rules that do not exist.

Filter by release datetime (inclusive start, YYYY-MM-DDTHH:MM:SSZ format).

Filter by release datetime (inclusive end, YYYY-MM-DDTHH:MM:SSZ format).

Search across filing title and associated company name. Case-insensitive. Multiple whitespace-separated terms are AND-combined (each term must match either the title or the company name).

Filter by a single data source ID.

Filter by the regulator's own form name, exactly as the source publishes it (e.g., 10-Q, 8-K, 6-K for SEC). Case-sensitive exact match; this is open free text that varies by regulator, not a controlled vocabulary.

Filter by data source ID(s). Comma-separated for multiple values (e.g., 38,40,51).

Filter by a single FinancialFilings Filing Type code (e.g., 10-K). An unrecognised code is rejected with a 400. These are FinancialFilings taxonomy codes, not regulator form names -- see GET /filing-types/.

Filter by multiple FinancialFilings Filing Type codes. Comma-separated (e.g., 10-K,IR). An unrecognised code is rejected with a 400. These are FinancialFilings taxonomy codes, not regulator form names -- a regulator's own form name belongs on the source_filing_type filter. See GET /filing-types/.

Filter by the date a filing was last updated on the platform (inclusive start, YYYY-MM-DDTHH:MM:SSZ format).

Filter by the date a filing was last updated on the platform (inclusive end, YYYY-MM-DDTHH:MM:SSZ format).

Controls the level of detail. Omit for a default 'summary' view, or use 'full' to include all details for each filing.