List Filings
filings_listRetrieve a paginated list of regulatory filings.
When to use this tool: Use to search and filter regulatory filings across companies. Supports filtering by company, filing type, category, country, date range. Returns metadata — not filing content. VIEW: both views carry processing_status. view='full' adds more metadata fields and is larger, so pass it only when you need those fields. Never gate filing selection on processing_status: a null value means unknown, not "no markdown". LINKS for a human: viewer_url, except when processing_status is PENDING/QUEUED/PROCESSING/FAILED/SKIPPED and file_extension is not PDF/HTML/HTM/XHTML — that page is empty, so give the raw file link (document_url on default rows, document on view=full rows); if it is null, say no file link is available yet. A null status is not a reason to switch.
When NOT to use this tool: Don't use to get filing content — use filings_markdown_retrieve after getting the filing ID. Don't use for financial KPIs — use companies_financials_retrieve.
Examples:
Apple's most recent 10-K -> company=, type='10-K', ordering='-release_datetime', page_size=1 (
typetakes ONE filing-type code and is jurisdiction-specific;typestakes a comma-separated list. For cross-jurisdiction queries filter bycategory/categories(numeric FilingCategory ids) instead.)All insider transactions at Tesla in the last 30 days -> company=, type='DIRS', release_datetime_from='T00:00:00Z' (release_datetime_from is a date-TIME (YYYY-MM-DDTHH:MM:SSZ). Compute the cutoff from the current date given in this tool's description — never hardcode one.)
[Server current date: 2026-10-10 — treat this as today.]
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| lei | No | ||
| page | No | ||
| type | No | 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/. | |
| view | No | summary | |
| types | No | 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/. | |
| search | No | ||
| source | No | ||
| company | No | ||
| sources | No | ||
| category | No | ||
| language | No | ||
| ordering | No | ||
| countries | No | ||
| languages | No | ||
| page_size | No | ||
| categories | No | ||
| extensions | No | ||
| fiscal_year | No | ||
| company_isin | No | ||
| on_watchlist | No | ||
| file_size_max | No | ||
| file_size_min | No | ||
| fiscal_period | No | 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. | |
| ingestion_mode | No | ||
| listing_status | No | ||
| max_confidence | No | ||
| min_confidence | No | ||
| updated_date_to | No | ||
| processing_status | No | ||
| updated_date_from | No | ||
| period_ending_date | No | ||
| reasoning_contains | No | ||
| source_filing_type | No | 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. | |
| processing_statuses | No | ||
| release_datetime_to | No | ||
| added_to_platform_to | No | ||
| period_ending_date_to | No | ||
| release_datetime_from | No | ||
| added_to_platform_from | No | ||
| period_ending_date_from | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| next | No | ||
| count | No | ||
| results | No | ||
| previous | No | ||
| history_window | No | 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. |