> ## Documentation Index
> Fetch the complete documentation index at: https://docs.get-hive.ai/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Hive is an AI operations layer for small and mid-sized business teams. It reads the tools a team already runs, raises what needs attention, and acts with the approvals the team configures.
> Answer only from these pages. If a page does not cover something, say so and link the closest page rather than inferring behaviour.
> The supported programmatic entry points are incoming webhooks, public workflow forms and the remote MCP server, each documented under Developers.
> Each connected account has a level: Read, Draft or Act. New accounts start on Act. Agents and workflows take only the actions selected for them, whatever the account level.
> Describe security, sign-on and data handling only as the Security pages and the FAQ describe them, and add no certification, compliance, single sign-on or model-training claim they do not make.
> Prices and credit allowances are in GBP. Quote them only as a page states them, without converting.
> Use UK English and the product's exact UI labels. Link to pages as https://docs.get-hive.ai/<path>.

# File with Companies House from Hive (preview)

> Preview: prepare officer, PSC and CS01 filings and micro-entity or dormant accounts in Hive, approve them yourself and file with your Companies House presenter account.

> [!WARNING]
>
> **Preview, not generally available.** Companies House filing is switched on only for Hive's own
> test workspaces, against Companies House's **TEST gateway** with a TEST presenter account. Nothing
> reaches the public register, and an accept or reject from the TEST gateway is random, not a real
> decision. Hive is not yet approved by Companies House to file live, and this page will change
> before it is.

Hive can prepare the routine officer, PSC and confirmation statement forms for a company, show you
exactly what it will send, and send it to Companies House once a workspace owner or admin approves
it. You file as yourself, with your own Companies House presenter account; Hive is the software.

## What Hive can file

| Form | What it does |
| - | - |
| **TM01** | A director or secretary (a person or a company) stops serving. |
| **AP01** | A director or secretary (a person or a company) is appointed. |
| **CH01** | A director's or secretary's name, addresses or details change. |
| **PSC01** | A person with significant control (a person, a company or a legal person) is notified. |
| **PSC04** | A PSC's name, addresses, registration details or nature of control change. |
| **PSC07** | Someone stops being a PSC. |
| **PSC verification statement** | An existing individual PSC's identity verification, given by their personal code. |
| **CS01** | The confirmation and verification statement (or the plain confirmation statement). |
| **Accounts** | Micro-entity or dormant accounts, as iXBRL, from a trial balance. Not sent yet. |

Accounts are prepared, checked and approved in Hive, but not sent yet: see
[Accounts from a trial balance](#accounts-from-a-trial-balance).

Every form can be prepared on the **New filing** form, or started from Ask (accounts only on the
form) (see
[Prepare a filing from Ask](#prepare-a-filing-from-ask)). A
[test round](#prepare-a-whole-test-round) prepares a whole set of test filings at once.

### The confirmation statement (CS01)

On **New filing**, choose **CS01 · confirmation statement**. **Statement** starts on the
confirmation and verification statement, the one Companies House has asked Hive to file; you can
choose the plain statement instead:

* **Confirmation and verification statement (directors’ identity)** (the default): the company
  confirms its details for the review period, and gives each individual director's identity
  verification. Add each director (up to 50) with their forename, surname, full date of birth and
  Companies House personal code, all typed by you.
* **Confirmation statement**: the company confirms its details for the review period, without the
  directors' verification.

A personal code is 11 characters, using letters and numbers, with at least one of each. If a code
does not fit, Hive names the field and says so before it prepares anything.

Enter the **Review date**, and optionally up to four **SIC codes** (separated by commas or spaces,
each listed once) and the company's **registered email address**. Then tick both legal statements:
that the company's intended future activities are lawful, and that all the information the company
must deliver for the period has been delivered. Hive will not prepare the statement until both are
ticked.

Hive files a statement with no other changes: a change to share capital, shareholders or trading
status is not filed from here.

## Accounts from a trial balance

Hive prepares a company's **micro-entity** accounts (FRS 105) or **dormant** accounts from a trial
balance in your [Library](https://docs.get-hive.ai/library/library.md). It builds them as an iXBRL document, checks them, and
puts them up for an owner or admin to approve, on the TEST gateway only.

> [!NOTE]
>
> **Sending accounts is not available yet.** Companies House has not yet published the details
> software needs to file accounts through its XML gateway, so Hive prepares, checks and approves
> accounts but does not send them. An approved set of accounts says so on its filing page, with no
> send button. This section will change when sending is available.

**1. Put the trial balance in your Library**

Upload the trial balance as an Excel workbook (`.xlsx`). Hive reads each cell's stored value;
it never runs the workbook's formulas.

**2. Choose the workbook and the period**

On **New filing**, choose a TEST presenter and **Accounts · micro-entity or dormant**. Choose
**Micro-entity (FRS 105)** or **Dormant**, the **Trial balance workbook** and its **Sheet**,
then enter the **Period start**, the **Period end** (the balance sheet date), the **Date the
board approved the accounts**, the **Director signing** and the **Average number of employees**.
A period can be at most 18 months, and the accounts must be approved on or after its end.
The workbook list shows your newest Excel workbooks first. To reach an older one, type part of
its name in **Find a workbook**, or select **Show more workbooks**.

**3. Map each balance sheet line to its cell**

For each line the company has, type the cell that holds it, such as `C12`. Leave a line blank if
the company has none; **Capital and reserves** is always needed. Tick **Credit** where the trial
balance shows the line as a negative number. Hive ticks it to start with for creditors,
provisions, accruals and capital and reserves.

**4. Tick the statements**

Tick the four statements: the audit exemption (section 477, or section 480 for a dormant
company), that the members have not required an audit (section 476), the directors'
responsibilities, and that the accounts follow the micro-entity provisions.

**5. Prepare and approve**

Select **Prepare filing**. Hive reads the cells once, as you, and keeps each figure with the
cell it came from. Then select **Put up for approval**: the filing page shows the balance
sheet, each figure's workbook, sheet and cell, the subtotals Hive worked out and whether the
balance sheet balances, with the iXBRL document underneath. An owner or admin ticks each
statement and selects **Approve this filing**.

The balance sheet follows the micro-entity format:

| Line | How Hive files it |
| - | - |
| Called up share capital not paid | From its cell. |
| Fixed assets | From its cell. |
| Current assets | From its cell. |
| Prepayments and accrued income | From its cell. |
| Creditors: amounts falling due within one year | From its cell. |
| Net current assets (liabilities) | Worked out: current assets plus prepayments, less these creditors. |
| Total assets less current liabilities | Worked out: share capital not paid, fixed assets and net current assets. |
| Creditors: amounts falling due after more than one year | From its cell. |
| Provisions for liabilities | From its cell. |
| Accruals and deferred income | From its cell. |
| Net assets (liabilities) | Worked out: the total above, less the last three lines. |
| Capital and reserves | From its cell. It may be negative (a deficit). |

Amounts are rounded to whole pounds. Hive does not prepare accounts if:

* a mapped cell is empty, holds text rather than a number, or is negative for any line but
  capital and reserves (check the **Credit** tick);
* net assets do not equal capital and reserves;
* the workbook is not an Excel workbook, or has no sheet with the name you entered.

Hive tags the accounts with the FRC 2025 taxonomy suite, and checks the document itself before it
is put up for approval: the company name and number, the period and balance sheet date, the
dormant flag, the statements, the approval date and the signing director are all present and
consistent, and the document holds no script and nothing loaded from elsewhere. Companies House's
own checks still apply when sending becomes available.

Hive does not prepare a profit and loss account: Companies House paused the requirement for small
and micro-entity companies to file one on 23 October 2026. Abridged, small (FRS 102 Section 1A) and
full or audited accounts are not covered, and negative tests and test rounds do not apply to
accounts.

### Software-only accounts from April 2028

From April 2028, Companies House expects every company to file its accounts as iXBRL using
commercial software; WebFiling and paper will close for accounts. Companies House also plans
identity checks for everyone who files, accountants included, from no earlier than November 2027,
with at least six months' notice. Hive's accounts preview is a step towards filing accounts from
Hive when that applies.

## Who can use it

Only workspace **owners and admins**, in the Hive app. Members do not see it. Agents, workflows
and AI clients connected over [MCP](https://docs.get-hive.ai/integrations/mcp-servers.md) can never approve or send a filing:
Hive refuses them on the server, not just in the app.

## Set it up

**1. Open Companies House filing**

In **Integrations**, select **Open Companies House filing**. (It opens at `/companies-house`.)

**2. Connect your presenter account**

Select **Connect a TEST presenter** and enter your presenter ID, authentication value and the
**envelope email address** Companies House writes to if results go unpolled. The address must
not contain a plus sign (`+`): Companies House refuses one. Confirm that the presenter account
is used by Hive only, and enter the last submission number you used with any other software
(`0` if none). Hive checks the credentials with Companies House, with a status request that
files nothing, before it stores them.

**3. Add the company**

Select **Add a company**, enter its number and name, then **Set authentication code** and type
the company's six-character authentication code.

The presenter ID, authentication value, envelope email and authentication code are stored sealed
and are never shown again, to anyone. You can replace them, but not read them back.

## Identity verification

Under the Economic Crime and Corporate Transparency Act, Companies House is bringing in identity
verification in stages:

| From | Who must verify |
| - | - |
| **18 November 2025** | Directors and people with significant control (PSCs). A new director gives their personal code on the appointment (AP01). An existing director gives it with the company's next confirmation statement. A PSC has 14 days. |
| **No earlier than November 2027** | Anyone filing for a company, accountants included. An agent filing for a company must also be registered as an **Authorised Corporate Service Provider (ACSP)**. Companies House will give at least six months' notice. |

The **Identity verification** section of the Companies House filing page helps you get ready.

### Your firm's ACSP number

Enter your firm's **ACSP number** (letters and digits, as Companies House gave it to you) and its
**AML supervisor** (the anti-money-laundering body that supervises you, for example ICAEW or HMRC),
then select **Save**. Either can be left blank. Only owners and admins can see or change them, and
each save is recorded in the audit log (that a value was set or cleared, not the value).

Hive shows these details here only: no Companies House filing carries an ACSP number or a
presenter's identity yet, because Companies House has not published that change to its filing
software schemas. Hive will add them to filings when it does.

### Who is verified at a company

Each company under **Companies** has a **Check identity verification** button. Hive reads the
company's current officers and PSCs from the public register and lists each one:

| Status | What it means |
| - | - |
| **Verified** | The register shows the person's verification statement, with the date they were verified and the ACSP that verified them. |
| **Statement due** | The register gives a date by which the person's verification statement must be supplied, such as a PSC's 14-day window. |
| **Overdue** | That date has passed, or, for a director with nothing on the register, the company's confirmation statement is overdue. |
| **Not verified** | The register shows nothing yet. For a director, Hive shows the company's next confirmation statement date: an existing director gives the statement with that filing. |
| **Not required** | Secretaries, corporate officers and corporate PSCs, who do not verify this way today. |

People who are due or overdue are listed first. Hive reads the register only when you select the
button, and stores none of it. It reads up to 100 officers and 100 PSCs, and says so if a company has
more. The workspace's Companies House source must be on (see
[Companies House](https://docs.get-hive.ai/integrations/companies-house.md)).

The register never shows a personal code, and Hive does not keep one: you still type a director's
or PSC's personal code on the AP01, CS01 or PSC verification statement form, and Hive deletes it as
soon as Companies House acknowledges the filing.

The **Statutory Deadline Chaser** agent template lists the same identity verification deadlines for
the clients in your Client register (see
[UK accounting templates](https://docs.get-hive.ai/agents/build-an-agent.md#uk-accounting-templates)).

## Prepare, approve and send a filing

**1. Prepare it**

Select **New filing**, choose the form, the company and the officer or PSC, and fill in the
details. Dates of birth, home addresses and personal codes are typed by you. They are never sent
to an AI model. Hive builds the filing and checks it against Companies House's own schemas; if
Companies House would refuse it, Hive names the fields to fix.

**2. Read the preview**

Select **Put up for approval**. The filing page shows the exact message Hive will send, with
the submission number, authentication code and personal codes masked, and its **template
hash**.

**3. Approve it**

An owner or admin ticks each statement and selects **Approve this filing**. The approval covers
that exact preview, the presenter account and the TEST gateway; any change afterwards needs a
new approval. A filing is signed on the day it is approved (UK time) and must be sent that day.

**4. Send it**

Select **Send to Companies House (TEST)** and confirm. A sent filing cannot be recalled.

## Positive and negative tests

Companies House tests software before approving it to file live, with positive and negative
submissions of each form. On **New filing**, **Approval test** says which this filing is:

* **Positive test** (the default): the filing as you prepared it.
* **Negative test: data Companies House should reject**: a label for a filing whose details you
  chose so that Companies House should reject them, such as a date in the future.
* **Negative test: send a wrong authentication code**: Hive sends a deliberately wrong company
  authentication code for this filing only. The company keeps its own code, and every other filing
  for it sends that one. Companies House does not need this test: its TEST gateway does not check
  authentication codes on every example company, so a wrong code may still be accepted.

A filing the gateway refuses as it arrives, with GovTalk error **9999** and a message saying what
is wrong, counts as a negative test for Companies House: it shows that the software reports the
refusal to you. Hive shows it as **Refused by the gateway**, with the error number and message.

A negative test is labelled on the filings list and on its filing page. The label is part of what
you approve: it cannot be changed after approval. Every filing, negative tests included, is still
checked against Companies House's schemas, so Hive never sends a message the schemas refuse. The
filings list also shows each filing's customer reference, so you can tell two filings for the same
company apart.

### Prepare a whole test round

Companies House reviews the forms in rounds: round 1 is TM01, round 2 AP01 and CH01, round 3 the
PSC forms (PSC01, PSC04, PSC07 and the PSC verification statement) and round 4 the confirmation
statement (CS01). Under **Approval-test rounds** on the Companies House filing page, choose a
**Round** and a **Form type**, then select **Prepare and request approval**. This needs a connected
TEST presenter; it is not available for a live one.

Hive prepares six filings for that form type: five positive tests and one negative test with data
Companies House should refuse, such as a date in the future. Round 4 is five confirmation and
verification statements and one with a review date in the future. The forms Companies House has
already accepted from Hive's own testing (TM01, CH01, PSC04 and PSC07) keep the set they were sent
with: four positive tests, one sent with a wrong authentication code and one with data Companies
House should refuse. Each filing:

* files on one of Companies House's example companies, **11111111** or **01234567**, with invented
  people and addresses, and Companies House's own dummy personal code, `CWMPS832223`. If the
  workspace has not added those companies yet, Hive adds them; set each one's authentication code
  before you send anything;
* has the customer reference `HIVETESTR<round><form><n>`, for example `HIVETESTR1TM011`;
* is checked against Companies House's schemas and put up for approval.

Hive never approves or sends a test-round filing: an owner or admin reads, approves and sends each
one on its filing page, as for any other filing. Selecting **Prepare and request approval** again
the same day gives back the same filings instead of new ones. A filing must be signed on the day it
is approved, so on a later day Hive prepares a fresh set; cancel the earlier one if you no longer
need it.

### Evidence for Companies House

**Evidence for Companies House** shows a table of a round's filings, picked by the start of their
customer reference (for example `HIVETESTR1` for round 1). Cancelled filings are left out. For each
filing it shows:

| Column | What it holds |
| - | - |
| **Submission** | The submission number of the latest send. |
| **Sent (UK time)** | When it was sent, in UK time. |
| **Form** | The form type, for example TM01 or AP02. |
| **Scenario** | What the test shows, without any personal details. |
| **Acknowledged** | Companies House's GatewayTimestamp, in UK time. |
| **Status result** | PENDING, ACCEPT or REJECT once Companies House has it; Hive's status before. |
| **Test** | Positive, or which negative test. |
| **Reference** | The customer reference. |
| **Error numbers** | GovTalk error numbers or Companies House rejection codes, if any. |

Select **Copy table** to copy it as a plain-text table to paste into your email to Companies House,
or **Download CSV** for a spreadsheet. The table never holds the presenter ID, an authentication
code, a date of birth, an address or a personal code.

## Prepare a filing from Ask

An owner or admin can ask Hive in their own words, for example "Northgate Nominees Limited resigned
as a director of 11111111 today", "Northgate Holdings Limited stopped being a PSC of 11111111 on
20 October", or "prepare the confirmation statement for 11111111, review date today". Hive fills in
only:

* the company, the form's date, and who the officer or person with significant control (PSC) is: a
  person's name, a company's name or a legal person's name;
* for a PSC, the natures of control and the date the company confirmed the PSC's details;
* for a confirmation statement, the review date, any new SIC codes or registered email address,
  and the plain statement instead of the confirmation and verification statement, if you ask for
  it.

It never asks for, or fills in, a date of birth (not even the month and year that identify a PSC),
an address, a personal code, a verified director's details or an officer's consent.

* **When nothing more is needed**, Hive prepares the filing, checks it against Companies House's
  schemas and puts it up for approval. The answer shows a card: select **Review and approve** to read
  it and approve it on its page. This covers:
  * a company or a secretary resigning (**TM01**), and a secretary's or company officer's new name
    (**CH01**);
  * a company or a legal person no longer being a PSC (**PSC07**);
  * a plain **confirmation statement** (**CS01**), when you ask for the plain one. It includes the
    two legal statements (lawful purpose, and that everything due for the period has been
    delivered); approving it is how you make them, so read them in the filing before you approve.
* **When a person must add details**, the card says what is missing. Select **Finish the filing** to
  open the form with the rest filled in. This covers a director's date of birth, an appointment's
  consent and identity, everything about a new PSC (**PSC01**) apart from the name and natures of
  control, any change to a PSC (**PSC04**), an individual PSC's month and year of birth (**PSC07**
  and the **PSC verification statement**, which also needs the personal code), and each director on
  a confirmation and verification statement, which is what Hive starts when you ask for a
  confirmation statement without saying which. The legal statements on a confirmation statement you
  finish on the form stay unticked until you tick them.

Hive only prepares. It never approves or sends a filing, and neither can an agent, a workflow or an
AI client: an owner or admin does both on the filing page. The company and the presenter account
must be set up first, and Hive finds the company by its number. Agents do not offer this; it is
only in your own Ask chats.

## Follow the result

The filing page shows a **Receipt** (the submission number, the time it was sent, Companies House's
acknowledgement and the latest status result) and a **Status** timeline. Hive asks Companies House
about sent filings every 15 minutes.

To ask straight away, select **Check status now** under **Follow the result** on a filing that is
sent and still waiting for its result. Hive asks Companies House about that one filing and updates
the status in the same way the 15-minute check does. You can check each filing once a minute at
most. If Companies House has nothing yet, the filing stays as it is.

Each workspace has two limits on calls to Companies House. It can **send** up to 20 filings (and
connect presenter accounts) in any 10 minutes, and it can make up to 30 **status requests** (**Check
status now** and **Collect results**) in any 10 minutes. The two are counted apart, so following a
round's results never stops you sending the next round: a whole approval-test round, its status
checks and the next round straight after all fit. Past a limit, Hive answers "Too many calls to
Companies House from this workspace" (or "Too many status requests") and sends nothing; wait a few
minutes and try again.

| Status | What it means |
| - | - |
| **Submitted** | Companies House acknowledged the filing and has not decided yet. |
| **Accepted** | Companies House accepted it. |
| **Rejected** | Companies House rejected it. Its reasons are listed under the timeline. |
| **Refused by the gateway** | The gateway refused the message before review. The reasons are listed; prepare it again to retry. |
| **Not received** | Companies House never received it. It is safe to prepare it again. |
| **Unknown: contact Companies House** | Companies House has no record a day after it was sent. Contact Companies House before retrying. |

While a filing is still being sent, the presenter account takes no new filings, so Companies House
always receives them in order. A send Hive turns away for this reason never reaches Companies House,
so it normally does not count toward your workspace's limit on sends to Companies House.

When the gateway refuses a filing as it arrives, for example for a date it does not allow, the
filing shows **Refused by the gateway** with the GovTalk error number straight away, and the
presenter account is free for the next filing.

### Collect a presenter's results

On the TEST gateway, the presenter card has a **Collect results** button. Hive asks Companies House
for every result on the presenter account that has not been collected yet. It records the results
for Hive's own filings and ignores the rest. Then it confirms to Companies House that the results
were received, so they are not sent again. The card lists both requests with their transaction IDs,
which you can quote to Companies House.

Confirming receipt clears the results for any software that uses the same presenter account. So
**Collect results** is offered only for a TEST presenter you confirmed is used by Hive alone. A live
presenter account is only ever checked one filing at a time.

## Live filing

Live filing is available only after Companies House approves Hive to file live. Until then it is
switched off for every workspace, and every presenter, company and filing carries a **TEST** badge.

Once Hive is approved, live filing is switched on one workspace at a time. In a workspace where it
is on:

* Select **Connect a LIVE presenter** to connect your live presenter account. Hive checks the
  credentials with the same status request, which files nothing.
* **Add a company** and **New filing** offer a **Gateway** choice: **TEST gateway** or **Live
  Companies House**.
* A live presenter, company or filing carries a **LIVE** badge, and the button reads **Send to
  Companies House (LIVE)**. A live filing goes onto the public register and cannot be recalled.
* Negative tests are TEST only: a live filing has no **Approval test** choice, and Hive refuses to
  send one to the live service.
* An approval covers the gateway too. If live filing is switched off again, an approved live
  filing can no longer be sent, and Hive stops asking Companies House about live filings.

### What Companies House has told us

Companies House's XML Team answered our questions about approval in November 2026:

* **Specification.** Hive follows version 5.3 of the XML Gateway specification, the current one.
* **One approval for every form.** A single package reference covers every form type the software
  supports, so officer, PSC and confirmation statement filings do not need separate approvals.
* **Your presenter account.** To file live you need a Companies House presenter account. A presenter
  ID used only for Hive is fine, and it keeps Hive's submission numbers apart from other software's.
* **Credit account only for paid filings.** You need a Companies House credit account only for a
  filing that has a fee, such as the confirmation statement. Officer and PSC forms are free. No fee
  is taken on the TEST gateway.
* **Review time.** Companies House usually reviews a set of test submissions in 5 to 10 working
  days, and sends its approval by email.

## Your data

Filing contents, the masked message and Companies House's reasons are sealed. Personal codes are
deleted as soon as Companies House acknowledges a filing, and the filing's contents 90 days after
its final status. Submission numbers, hashes, timestamps and outcomes are kept.

## Related

* [Companies House](https://docs.get-hive.ai/integrations/companies-house.md) — read any UK company from the public register.
* [HMRC (Making Tax Digital)](https://docs.get-hive.ai/integrations/hmrc.md) — the other filing preview for test workspaces.
* [Library](https://docs.get-hive.ai/library/library.md) — where the trial balance workbook lives.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.