List a company's annual financial statements
get_financialsRetrieve annual accounts filings (financial statements) for a company by jurisdiction and ID. Filters by year or exact period end date. Returns fiscal period dates, document ID, format, and download URL. Results sorted newest first.
Instructions
Return annual-accounts filings (financial statements) for a company. Convenience wrapper over list_filings(category='accounts') that normalizes the fiscal-period shape across registries and pre-computes the download URL so callers don't need a second get_document_metadata round-trip.
Each item has period_end (fiscal-period end date, the primary sort key a user thinks in), optional period_start / registration_date, a document_id that can be passed to fetch_document, document_format (e.g. XBRL XML, XHTML, PDF — may be empty when the upstream negotiates format on fetch), source_url for direct download, and jurisdiction_data carrying raw upstream fields verbatim. Results are newest-first.
Filters: year=YYYY keeps periods ending in that calendar year; period_end=YYYY-MM-DD pinpoints a single period (takes precedence over year). limit caps the post-filter slice — omit to return all matches. The whole accounts history is walked per query because late-filed amendments can land out of order.
If the adapter doesn't implement list_filings at all, this returns 501. Per-country caveats (ID format, document format availability, whether bodies are paid) — call list_jurisdictions({jurisdiction:"<code>"}).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| jurisdiction | Yes | ISO 3166-1 alpha-2 country code (uppercase). All registries are official government sources. Currently supported: AU, BE, CA, CA-BC, CA-NT, CH, CY, CZ, DE, ES, FI, FR, GB, HK, IE, IM, IS, IT, KR, KY, LI, MC, MX, MY, NL, NO, NZ, PL, RU, TW. Per-country capability, ID format, examples, status mapping, and caveats: call `list_jurisdictions({jurisdiction:'<code>'})`. To find which countries support a specific tool: `list_jurisdictions({supports_tool:'<tool>'})`. | |
| company_id | Yes | Registry-specific company ID. | |
| year | No | Filter to fiscal periods ending in this calendar year (e.g. 2024 → any period_end starting '2024-'). Useful when the company uses a non-calendar fiscal year. | |
| period_end | No | Filter to an exact fiscal period end date (YYYY-MM-DD, e.g. '2024-12-31'). Takes precedence over `year`. | |
| limit | No | Cap on returned items. Omit to return ALL matching items (post-filter). GB and FI native paths paginate through every accounts filing (GB up to 2000); the fallback projection over list_filings is bounded by the adapter's own list_filings page size. | |
| fresh | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| queried_at | Yes | ISO-8601 + Europe/London timezone stamp for when the registry was queried. | |
| items | No | ||
| total_count | No | ||
| next_cursor | No |