Skip to main content
Send a company name (optionally with a website, postcode, address, SIC code, or trading date) and get back the best matching UK company registration number (CRN), plus the registered name, active status, and a confidence level.
This API is in beta. It is stable enough to build against and serves production data. Keys are issued by hand. Email support@thedatacity.com to get one. Feedback now shapes what ships next.

What you get back

Each result includes a confidence level, so you can decide how much to trust it. See the response reference for what every field contains. A single POST /match returns one result. For lists, submit a batch and poll until it completes, or pass callback_url to be notified once.

Who it’s for

Use this API when you need to attach a reliable Companies House identity to customer lists, CRM records, or enrichment pipelines.

How to get started

Quickstart

Get an API key and match your first company in a few minutes.

Authentication

Customer API keys (dm_live_…) as a Bearer token.

Response reference

Every field in the response, and when it is empty.

Batch matching

Submit up to 1,000 companies and poll for results.

Errors

Status codes, what they mean, and what to do.

Rate limits

Per-minute limits on match endpoints.

Data handling

Where the data you submit goes, and how long we keep it.

Versioning

The /api/v1 contract, the release number, and what counts as breaking.

Changelog

Material changes to the API, newest first.

Base URL

Before release 1.17.0 the address was https://datamatcher-api.thedatacity.com. It answers API calls until 12 February 2027. Move your integration to the address above before then.
All match endpoints sit under /api/v1/match. The interactive playground on each endpoint page lets you paste your API key and send live requests.
Last modified on November 11, 2026