About this endpoint
What it does
Looks up a live UK company by its company registration number and returns the company record from the latest monthly snapshot.
Path Parameter
| Parameter | Type | Description |
|---|---|---|
| number | String | Required. Company registration number: up to 8 digits (padded with leading zeros, so 445790 = 00445790) or 2 letters + 6 digits, for example SC045551. Case-insensitive. |
Response
Returns a JSON object with the company details and source metadata.
| Parameter | Type | Description |
|---|---|---|
| country | String | Always GB. |
| companyNumber | String | Company number, normalised to 8 characters and uppercase. |
| name | String | Registered company name. |
| companyType | String | Company type, for example Private Limited Company or Public Limited Company. |
| status | String | Company status, for example Active or Active - Proposal to Strike off. |
| incorporationDate | String | Incorporation date (YYYY-MM-DD). |
| registeredOffice | Object | Registered office address. |
| registeredOffice.line1 | String | First address line. |
| registeredOffice.line2 | String | Second address line. Null when not registered. |
| registeredOffice.postTown | String | Post town. Null when not registered. |
| registeredOffice.county | String | County. Null when not registered. |
| registeredOffice.country | String | Country as written on the register. Null when not registered. |
| registeredOffice.postcode | String | Postcode. |
| sicCodes | Object Array | SIC 2007 industry codes. Can be empty. |
| sicCodes[].code | String | 5-digit SIC code. |
| sicCodes[].label | String | SIC code description. |
| accounts | Object | Annual accounts filing details. |
| accounts.category | String | Accounts category, for example FULL, GROUP, MICRO ENTITY, TOTAL EXEMPTION FULL, NO ACCOUNTS FILED. |
| accounts.lastMadeUpTo | String | Date of the last filed accounts (YYYY-MM-DD). Null when no accounts are filed yet. |
| accounts.nextDue | String | Due date of the next accounts (YYYY-MM-DD). |
| confirmationStatementNextDue | String | Due date of the next confirmation statement (YYYY-MM-DD). |
| outstandingMortgages | Integer | Number of outstanding mortgages or charges. |
| previousName | String | Most recent previous company name. Null when the company was never renamed. |
| companiesHouseUrl | String | Link to the company page on the official register. |
| source | String | Name of the source dataset. |
| licence | String | Reuse terms of the source data. |
| attribution | String | Credit line to show wherever you display the data. |
| sourceDate | String | Date of the source snapshot (YYYY-MM-DD). |
| extractedAt | String | Date the record was served (YYYY-MM-DD). |
Notes
- Only live companies are included. A dissolved or unknown number returns
404with{"error": {"status": 404, "message": "Company not found among live UK companies in the latest monthly snapshot"}}. - An invalid number returns
400with{"error": {"status": 400, "message": "Invalid UK company number (e.g. 00445790, SC123456)"}}. - Data is refreshed monthly, so changes filed after
sourceDateare not shown yet.



