List the filings submitted by a company to its registry
list_filingsRetrieve a company's filing history sorted newest-first, with optional filtering by category and pagination. Use jurisdiction and company_id to get filings; pass back cursor or offset for additional pages.
Instructions
Return a company's filing history. Each filing has a filing_id, filing_date, category, description, and (when upstream exposes one) a document_id that round-trips to get_document_metadata / fetch_document. Raw upstream fields come through verbatim under jurisdiction_data. Results are newest-first.
Use the optional category parameter to filter. Common normalized categories: 'accounts', 'annual-return', 'capital', 'charges', 'confirmation-statement', 'incorporation', 'insolvency', 'liquidation', 'mortgage', 'officers', 'persons-with-significant-control', 'resolution'. Some jurisdictions also accept native form codes directly — pass the upstream code through unchanged if you have one.
Pagination: limit (default 25, max 1000). Some adapters use cursor pagination — pass back next_cursor as cursor to continue. Others use numeric offset. has_document flags whether the body can actually be retrieved via fetch_document; some registries expose only the metadata listing with the body paywalled or unavailable.
Not every registry publishes a filing list; unsupported jurisdictions return 501. Per-country caveats (ID format, accepted category values, cursor vs offset, document availability and pricing, paid-tier gates) — 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. IE accepts an optional '/B' suffix for the business-name register. | |
| category | No | Optional filter on standardized category. GB: native Companies House category strings. IE: 'accounts'|'annual-return'|'capital'|'charges'|'incorporation'|'insolvency'|'officers'|'prospectus'|'registered-office'|'resolution'. IM: 'annual-return'|'articles'|'memorandum'|'incorporation'|'name-change'|'officers'|'resolution'|'charges' (mapped to upstream AR/AA/MA/INC/CCN/9N/RES/CRS; pass the raw upstream code directly for any other IoM document type). IS: 'annual-return'|'incorporation'|'articles'|'supplementary-notice'|'other', or the Icelandic column names ('Stofngögn'/'Samþykktir'/'Aukatilkynningar'/'Önnur gögn'), or the raw numeric typeid (1/4/5/6/7). | |
| limit | No | Items per page. Default 25. | |
| offset | No | IE only. Skip the first N filings (pagination). Combine with limit. | |
| cursor | No | GB only. Opaque pagination cursor returned by a previous call as 'next_cursor'. Omit for the first page. | |
| 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 |