get_company_filings
Retrieve a company's filing history including dates, types, and descriptions. Access filings from 140+ jurisdictions using OpenCorporates.
Instructions
Get the filing history for a specific company. Returns filings with dates, types, and descriptions.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| jurisdiction_code | Yes | Jurisdiction code (e.g. 'us_de', 'gb', 'de') | |
| company_number | Yes | Company registration number | |
| page | No | Page number for pagination (default 1) |
Implementation Reference
- src/index.ts:82-86 (schema)TypeScript interface defining the input arguments for get_company_filings: jurisdiction_code (string), company_number (string), and page (optional number).
interface GetCompanyFilingsArgs { jurisdiction_code: string; company_number: string; page?: number; } - src/index.ts:169-188 (registration)Registration of the 'get_company_filings' tool in the ListToolsRequestSchema handler, including its description and input JSON schema (jurisdiction_code, company_number required; page optional).
{ name: "get_company_filings", description: "Get the filing history for a specific company. Returns filings with dates, types, and descriptions.", inputSchema: { type: "object", properties: { jurisdiction_code: { type: "string", description: "Jurisdiction code (e.g. 'us_de', 'gb', 'de')", }, company_number: { type: "string", description: "Company registration number", }, page: { type: "number", description: "Page number for pagination (default 1)" }, }, required: ["jurisdiction_code", "company_number"], }, }, - src/index.ts:330-351 (handler)Handler implementation for the 'get_company_filings' tool. Calls OpenCorporates API at /companies/{jurisdiction_code}/{company_number}/filings, maps the response to title/date/filing_type/description/opencorporates_url, and returns as JSON text.
case "get_company_filings": { const { jurisdiction_code, company_number, page } = args as unknown as GetCompanyFilingsArgs; if (!jurisdiction_code || !company_number) throw new Error("Parameters 'jurisdiction_code' and 'company_number' are required"); const data = (await apiFetch( `/companies/${jurisdiction_code}/${encodeURIComponent(company_number)}/filings`, { page } )) as { results: { filings: Array<{ filing: Record<string, unknown> }> } }; const filings = data.results?.filings ?? []; if (filings.length === 0) return textResult("No filings found for this company."); const out = filings.map(({ filing: f }) => ({ title: f["title"], date: f["date"], filing_type: f["filing_type"], description: f["description"], opencorporates_url: f["opencorporates_url"], })); return textResult(JSON.stringify(out, null, 2)); }