Getting started with UK Company Verification for Microsoft Dynamics 365 Business Central

1. Get your free Companies House API key (5 minutes)

  1. Go to the Companies House developer hub: https://developer.company-information.service.gov.uk/
  2. Sign in or create a free account.
  3. Create an application (any name, for example "Business Central"), choose the live environment, and add a REST API key.
  4. Copy the key. It is yours: the request limit (600 requests every 5 minutes) belongs to your key, not to anyone else.

2. Set up the app in Business Central

  1. Search for Companies House Setup and open it.
  2. Paste the key into API Key (it is masked and stored encrypted).
  3. Choose Test connection. You should see a success message.
  4. Optional: under Background Refresh, choose Provision Job Queue entry to refresh your customers and vendors automatically on a schedule. You can also Run refresh now.

3. Look up a company on a customer or vendor card

  1. Open a customer or vendor card.
  2. Enter the Companies House Number — or type the name and let the app search.
  3. On the Companies House Search Results page, pick the right company.
  4. Choose Fill Name & Address from CH to copy the registered name and address onto the card.

The Companies House FactBox now shows the company's status, risk score, liquidation and strike-off signals, outstanding charges and whether accounts or the confirmation statement are overdue. Officers and persons with significant control appear in their own lists.

4. Keep it current

  • Refresh from CH on a card updates that company now.
  • When you refresh a card by hand and the status, filings, distress signals or officers have changed, the app shows a message.
  • The background refresh updates linked UK customers and vendors (country GB or blank) once their last check is older than Refresh Frequency (Days) on the setup page, and records each change in the change log — check it regularly.
  • View CH Change Log shows every change a refresh made, with old and new values and the date.

5. Warnings before you post, and bank-change evidence

  • When you release or post a sales document, or post a payment journal, for a customer or vendor linked to Companies House whose stored status is dissolved, liquidation, administration, receivership, insolvency-proceedings or converted-closed, the app shows a warning and asks whether to continue. Choose Yes to carry on — it never blocks posting. It uses the status already stored on the card (no live call), and each warning is recorded in the change log.
  • When a vendor linked to Companies House has a bank account added with bank details, or its account number, sort code or IBAN changes, the app builds an evidence card for whoever approves the change: company status, vendor name against the registered name, and registered office, director and PSC changes in the last 90 days, rated None, Review or High. A notification offers Show evidence. The change itself is never blocked, and the change log keeps only the last 4 characters of the bank details.

6. Load many companies at once

  1. Search for Companies House Bulk Import.
  2. Step 1 — choose whether you are matching customers or vendors.
  3. Step 2 — Upload CSV with your record numbers and company numbers.
  4. Step 3 — Open preview to see which rows match and which will be skipped.
  5. Step 4 — confirm and apply.

7. Risk score

The 0–100 score adds weighted points for status, insolvency signals, overdue filings, recent director resignations and a recently changed registered office, and lists the reasons. Open CH Risk Score Weights to change the weights.

8. Monitor your own company

On Company Information, enter your own company number in CH Number (self-monitor) and choose Refresh CH self-monitor to see your statutory filing health.

Need help?

See the Support page.

UK Company Verification uses Companies House data. It is not provided or endorsed by Companies House.

Follow on LinkedIn