apyhub
Back

UK Company Lookup API

What it does

The UK Company Lookup API returns the official record for a UK company from its company registration number. Send the number in the path and get back JSON with the company name, status, type, incorporation date, registered office, SIC codes with labels, accounts category and next accounts / confirmation statement due dates.

Pass number as the 8-character company number, for example 00445790 or SC100000. Shorter numbers are padded with leading zeros, and letters are case-insensitive. The API covers live (not dissolved) companies, refreshed monthly. Dissolved companies return a 404, and invalid numbers return a 400.

Every response includes source, licence, attribution and a data date. The record holds company facts only, with no officers or other personal data.

Teams use this UK company lookup API to check a supplier before onboarding, to fill company details into a CRM from a company number, to tag accounts by SIC code, and to flag companies with overdue accounts.

Pair it with the VAT Company Lookup API to confirm a VAT number for the same business, or the Company KYB Lookup API to search by company name or LEI when you do not have a company number yet.

Contains public sector information licensed under the Open Government Licence v3.0.

GET
UK company (Companies House monthly snapshot)
https://api.eu.apyhub.com/nordic-data-tools/uk-company-lookup/uk/company/:number

QUICKSTART

GUIDE

Quickstart

Look up Tesco PLC by its Companies House number.

curl -X GET "https://api.eu.apyhub.com/nordic-data-tools/uk-company-lookup/uk/company/:number" \
  -H "apy-token: $APY_TOKEN"

What you'll get back

Returns a JSON object with the company details, registered office, SIC codes, accounts dates and source metadata.

{
  "country": "GB",
  "companyNumber": "00445790",
  "name": "TESCO PLC",
  "companyType": "Public Limited Company",
  "status": "Active",
  "incorporationDate": "1947-11-27",
  "registeredOffice": {
    "line1": "TESCO HOUSE, SHIRE PARK",
    "line2": "KESTREL WAY",
    "postTown": "WELWYN GARDEN CITY",
    "county": null,
    "country": "UNITED KINGDOM",
    "postcode": "AL7 1GA"
  },
  "sicCodes": [
    {
      "code": "47110",
      "label": "Retail sale in non-specialised stores with food, beverages or tobacco predominating"
    }
  ],
  "accounts": {
    "category": "GROUP",
    "lastMadeUpTo": "2026-02-28",
    "nextDue": "2027-08-26"
  },
  "confirmationStatementNextDue": "2027-07-02",
  "outstandingMortgages": 2,
  "previousName": null,
  "companiesHouseUrl": "https://find-and-update.company-information.service.gov.uk/company/00445790",
  "source": "Companies House Free Company Data Product (BasicCompanyData)",
  "licence": "Companies House imposes no reuse restrictions on public register data",
  "attribution": "Source: Companies House (processed by Nordic Data Tools)",
  "sourceDate": "2026-11-19",
  "extractedAt": "2026-11-20"
}
TRY ITLIVE · 40 ATOMS
Loading your default key…
The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.
Companies House company number. Up to 8 digits (shorter numbers are padded with leading zeros, so 445790 = 00445790) or 2 letters + 6 digits, for example SC045551. Letters are case-insensitive.

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

ParameterTypeDescription
numberStringRequired. 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.

ParameterTypeDescription
countryStringAlways GB.
companyNumberStringCompany number, normalised to 8 characters and uppercase.
nameStringRegistered company name.
companyTypeStringCompany type, for example Private Limited Company or Public Limited Company.
statusStringCompany status, for example Active or Active - Proposal to Strike off.
incorporationDateStringIncorporation date (YYYY-MM-DD).
registeredOfficeObjectRegistered office address.
registeredOffice.line1StringFirst address line.
registeredOffice.line2StringSecond address line. Null when not registered.
registeredOffice.postTownStringPost town. Null when not registered.
registeredOffice.countyStringCounty. Null when not registered.
registeredOffice.countryStringCountry as written on the register. Null when not registered.
registeredOffice.postcodeStringPostcode.
sicCodesObject ArraySIC 2007 industry codes. Can be empty.
sicCodes[].codeString5-digit SIC code.
sicCodes[].labelStringSIC code description.
accountsObjectAnnual accounts filing details.
accounts.categoryStringAccounts category, for example FULL, GROUP, MICRO ENTITY, TOTAL EXEMPTION FULL, NO ACCOUNTS FILED.
accounts.lastMadeUpToStringDate of the last filed accounts (YYYY-MM-DD). Null when no accounts are filed yet.
accounts.nextDueStringDue date of the next accounts (YYYY-MM-DD).
confirmationStatementNextDueStringDue date of the next confirmation statement (YYYY-MM-DD).
outstandingMortgagesIntegerNumber of outstanding mortgages or charges.
previousNameStringMost recent previous company name. Null when the company was never renamed.
companiesHouseUrlStringLink to the company page on the official register.
sourceStringName of the source dataset.
licenceStringReuse terms of the source data.
attributionStringCredit line to show wherever you display the data.
sourceDateStringDate of the source snapshot (YYYY-MM-DD).
extractedAtStringDate the record was served (YYYY-MM-DD).

Notes

  • Only live companies are included. A dissolved or unknown number returns 404 with {"error": {"status": 404, "message": "Company not found among live UK companies in the latest monthly snapshot"}}.
  • An invalid number returns 400 with {"error": {"status": 400, "message": "Invalid UK company number (e.g. 00445790, SC123456)"}}.
  • Data is refreshed monthly, so changes filed after sourceDate are not shown yet.
▣ COMMON ERRORS

Errors any endpoint can return

400bad_request

Required parameter missing or malformed body.

401unauthorized

API key missing, revoked, or not authorized for this service.

429rate_limited

Your plan's per-second rate exceeded. Retry with exponential backoff.

503upstream_busy

Backend temporarily unavailable. Try again in a few seconds.