Companies House

Companies House Company Profile API

The full register entry for one UK company, straight off the official statutory register: status, type, incorporation and dissolution dates, registered office, SIC codes, previous names, accounts and confirmation-statement due dates with their overdue flags, and whether the company has charges, insolvency history, officers or UK establishments. Keyed by company_number - get one from the search endpoint. Costs 1 credit per request.

POST/api/v1/companieshouse/company

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>, where <token> is your Scavio API key (e.g. Bearer sk_live_your_key).

Body

application/json

company_numberstringrequired

UK company number, 1-20 characters. Deliberately loose: it is zero-padded to 8 and upper-cased for you, so 445790, 00445790 and sc090312 all resolve. That matters because the register itself 404s on the unpadded and lower-cased forms - a number typed off a letterhead, or pulled from a spreadsheet that ate its leading zeros, would otherwise fail. Registry prefixes are supported: SC (Scotland), NI (Northern Ireland), OC/SO/NC (LLPs), FC (overseas), BR (UK establishment), CE (charitable incorporated organisation). Up to two letters followed by digits, 8 characters after padding; anything else is a 400.

Example: 00445790

Request

from scavio import ScavioClient

client = ScavioClient(api_key="sk_live_your_key")

# Unpadded and lower-cased numbers are normalised for you: this is 00445790.
profile = client.companies_house.company("445790")
data = profile["data"]

print(data["company_name"], data["company_status"])
print("accounts overdue:", data["accounts_overdue"])
print("has charges:", data["has_charges"])

Response

"company_number": "00445790",

"company_name": "TESCO PLC",

"company_url": "https://find-and-update.company-information.service.gov.uk/company/00445790",

"company_status": "Active",

"company_type": "Public limited Company",

"incorporation_date": "1947-11-27",

"incorporation_date_label": "Incorporated on",

"registered_office_address": "Tesco House, Shire Park, Kestrel Way, Welwyn Garden City, United Kingdom, AL7 1GA",

"registered_office_address_label": "Registered office address",

"accounts_next_made_up_to": "2027-02-26",

"accounts_next_due": "2027-08-26",

"accounts_last_made_up_to": "2026-02-28",

"confirmation_statement_next_made_up_to": "2027-06-18",

"confirmation_statement_next_due": "2027-07-02",

"confirmation_statement_last_made_up_to": "2026-06-18",

"accounts_overdue": false,

"confirmation_statement_overdue": false,

"has_charges": true,

"has_insolvency": false,

"has_officers": true,

"has_uk_establishments": false,

"officers_url": "https://find-and-update.company-information.service.gov.uk/company/00445790/officers",

"filing_history_url": "https://find-and-update.company-information.service.gov.uk/company/00445790/filing-history",

"charges_url": "https://find-and-update.company-information.service.gov.uk/company/00445790/charges",

"persons_with_significant_control_url": "https://find-and-update.company-information.service.gov.uk/company/00445790/persons-with-significant-control"

"response_time": 1020,

"credits_used": 1,

"credits_remaining": 4820

}

from scavio import ScavioClient client = ScavioClient(api_key="sk_live_your_key") # Unpadded and lower-cased numbers are normalised for you: this is 00445790. profile = client.companies_house.company("445790") data = profile["data"] print(data["company_name"], data["company_status"]) print("accounts overdue:", data["accounts_overdue"]) print("has charges:", data["has_charges"])