--- name: "companies_save_accounts" area: "companies" title: "Save a UK company's filed accounts" price: "$0.001" method: "POST" url: "https://api.conecto.chat/v1/tools/companies_save_accounts" mcp_server: "https://api.conecto.chat/mcp/companies" auth: "Authorization: Bearer " docs_url: "https://conecto.chat/tools/companies/companies_save_accounts" --- # Save a UK company's filed accounts (`companies_save_accounts`) A UK company's annual accounts as filed with Companies House, saved to the file store as a PDF: the latest, or a year's. A UK company's annual accounts as filed with Companies House, saved to the file store as the PDF it holds: the latest, or those made up to made_up_to (a year or a date). Big companies file theirs as scans, which no register publishes as figures: companies_read_accounts then reads the statements by OCR, and documents_page_images shows the pages to check. Saving the same filing again gives back the file already saved. Price: $0.001 a call. A call that fails costs nothing. ## Use it when When companies_financials finds no figures for a UK company, which is how big private companies file: as scans. - For figures a register publishes as data, use [companies_financials](https://conecto.chat/tools/companies/companies_financials.md). - For the statements in the saved PDF, use [companies_read_accounts](https://conecto.chat/tools/companies/companies_read_accounts.md). ## Say this to your agent > We're looking at buying Harbour Lane Coffee. Get its latest accounts from Companies House and tell me its revenue and profit. ## Inputs | Name | Type | Required | Description | Allowed values | Default | |---|---|---|---|---|---| | `company` | string | yes | A UK company id from companies_search, like gb:08130873. 4 to 40 characters. | | | | `made_up_to` | string | no | The accounts made up to this date (2025-03-31) or in this year (2025). Matches ^\\d{4}(-\\d{2}-\\d{2})?$. | | | ## Example Written for Hansen & Voss, a restaurant-equipment wholesaler in Hamburg with 60 staff. MCP: call `companies_save_accounts` on the MCP server `https://api.conecto.chat/mcp/companies` with these arguments: ```json { "company": "gb:09876543" } ``` REST: ```bash curl https://api.conecto.chat/v1/tools/companies_save_accounts \ -H "Authorization: Bearer $CONECTO_KEY" \ -H "Content-Type: application/json" \ -d '{"company": "gb:09876543"}' ``` ## Response ```json { "call_id": "5f0c8a2e-3b7d-4c1e-9a64-2d8e1f7b0c93", "tool": "companies_save_accounts", "status": "succeeded", "replayed": false, "cost_usd": "$0.001", "balance_usd": "$19.75", "result": { "company": "gb:09876543", "name": "HARBOUR LANE COFFEE (EUROPE) LIMITED", "made_up_to": "2025-03-31", "filed": "2025-12-18", "accounts_type": "full", "amended": false, "pages": 4, "scan": true, "machine_readable": false, "already_saved": false, "file": { "file_id": "6e86e107-3f38-4d20-b951-715c20f438f2", "name": "Harbour Lane Coffee (Europe) Limited accounts to 2025-03-31.pdf", "content_type": "application/pdf", "size": "203.4 KB", "size_bytes": 208308, "sha256": "53f82931ce12407294335021a88ceda2867c32a7760e995ed41cbfb2165a01ea", "created_at": "2026-10-14T08:00:00+00:00", "download_url": "https://cncto.co/d/6e86e107-3f38-4d20-b951-715c20f438f2?t=eyJmIjoiNmU4NmUxMDctM2YzOC00ZDIwLWI5NTEtNzE1YzIwZjQzOGYyIiwiZXhwIjoxNzkyODY5MDg2fQ:1xKKfm:SNkVU0kEWVRMTNZD9PNbbyZ4H1RA05cpsqXNr6Xbdds", "link_expires_in_hours": 24 }, "next": "A scan: companies_read_accounts with file_id 6e86e107-3f38-4d20-b951-715c20f438f2 reads its statements by OCR, and documents_page_images shows the pages to check." } } ``` `result`: company, name, made_up_to, filed, accounts_type, pages, scan (no text in the PDF, so it is read by OCR), machine_readable (also filed as data), already_saved, file (file_id, name, download_url) and next. ## Errors | Code | Status | When | Fix | |---|---|---|---| | `invalid_input` | 400 | The company isn't a UK one (a gb: id), or its id isn't valid. | Find the UK id with companies_search; for a company elsewhere, upload its annual report with files_upload. | | `not_found` | 404 | Companies House has no annual accounts for it, or none made up to that date. | Leave out made_up_to for the latest, or try another year. | | `unavailable` | 503 | A register didn't answer, or the UK register isn't connected yet. | Try again in a minute. For a UK company, search by name and use its LEI. | The refusals every tool can give (401 key, 402 balance, 429 limits) are on the errors page: https://conecto.chat/docs/errors.md ## Related - [companies_search](https://conecto.chat/tools/companies/companies_search.md): Companies by name or id across the public registers, each with its id, country, status, city and industry, best match first. Free up to 1,000,000 reads a month. - [companies_get](https://conecto.chat/tools/companies/companies_get.md): A company's record in its register: legal form, status, address, industry, employees, LEI and its officers by name and role. $0.05 a call. - [companies_financials](https://conecto.chat/tools/companies/companies_financials.md): Up to ten years of a company's filed figures in one shape, each with its source document, plus growth, margins, returns and payment days. $0.05 a call. - [companies_read_accounts](https://conecto.chat/tools/companies/companies_read_accounts.md): The balance sheet and income statement read out of an annual report PDF, a scan by OCR, line by line with its page, German HGB or English. $0.05 a call. - [companies_owners](https://conecto.chat/tools/companies/companies_owners.md): A company's parents and subsidiaries from GLEIF, the SEC and Wikidata and, in the UK, the people and companies with significant control. $0.05 a call. - [companies_legal_notice](https://conecto.chat/tools/companies/companies_legal_notice.md): A company's legal notice (Impressum) read from its own website: legal name, register court and number, managers and VAT number. $0.01 a call. - [companies_estimate](https://conecto.chat/tools/companies/companies_estimate.md): A revenue estimate from headcount and Eurostat's turnover per person employed for the size class and industry, always labeled as an estimate. Free up to 1,000,000 reads a month. - [companies_match](https://conecto.chat/tools/companies/companies_match.md): Matches a company list (CSV, Excel or rows) to the registers in the background, with a results file of each match. $0.01 per row matched.