Companies House Filing History API — UK Filings
Every document a UK company files lands on the public register with a date and a description. This source returns that history — what was filed, when, and a link to the document itself.
- You send
- A UK company number
- You get back
- Every filing with its date, description and document link
- Coverage
- United Kingdom — entities on Companies House.
- Price
- 5 pts — $5 per 1,000
- Charged only when the record resolves. A lookup that finds nothing is not billed.
Ways to get this data
Three approaches teams use today, and where each one runs into trouble.
| Approach | What it takes | Cost | Trade-off |
|---|---|---|---|
| Companies House directly | Register for a key and page through the filing-history endpoint yourself | Usually free, sometimes per-document | A different interface, language and data shape for every country you add |
| Collecting it yourself | Build and host a crawler per register, then keep each one alive | Infrastructure and maintenance | Registers change their pages without warning, and nobody is on the hook when yours breaks |
| NeuralVerge | One request, the same shape as every other source in the catalog | $5 per 1,000, misses not billed | Covers United Kingdom — other countries are separate sources with the same request format |
What you get back
Every field the response returns.
| Field | Type | Description |
|---|---|---|
filings | array | Every filing the company has made. |
filings[].date | string | Date the filing was made. |
filings[].description | string | Full description of the filing event. |
filings[].type | string | Category, for example confirmation statement or annual accounts. |
filings[].transaction_id | string | Transaction number or barcode for the filing. |
filings[].document_url | string | Direct link to the filed document. |
Every source answers in the same shape: a session id, a readable human summary, a structured machine object and the points the call consumed. Learn it once and it holds across every source in the catalog.
How to run it
The same lookup works from the app, the API, or as a tool an agent can call mid-task.
A JSON schema passed as extract_schema_json pins the response shape, which is why one endpoint serves every register in the catalog — only the URL and the schema change. The Get API Code button in the app hands you the complete command with the schema already filled in.
curl -X POST https://api.neuralverge.ai/functions/v1/run-extract \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"url": "https://find-and-update.company-information.service.gov.uk/company/08804411/filing-history",
"instructions": "Extract data from Companies House",
"settings": {
"country_code": "us",
"extract_schema_json": "{ ... }"
}
}'What teams use it for
Where this field shows up in an actual workflow.
Spot late accounts and charges before they become someone else's problem.
Assemble the document trail for a counterparty without downloading each file by hand.
Watch for the filings that signal a restructure, a raise or a wind-down.
Keep a dated, linked record of what the register said when you checked it.
Coverage, freshness and limits
What this source covers, how fresh it is, and where it stops.
United Kingdom — entities on Companies House.
Read at request time, so the answer reflects the register as it stands when you ask.
Companies House is a public register. Every response carries the source URL it was read from and a session id you can trace.
- —It returns the index of filings and their links, not the parsed contents of each document.
- —Filing descriptions are the register's own wording and vary in specificity.
- —Companies that have never filed anything return an empty history rather than an error.
Questions, answered
It returns the filing index — date, description and a link to each document. To read inside a specific document, pass its link to AI Extract with a schema for what you want out of it.
Related sources
Try companies house filings on your own data
One request format across every source in the catalog.