# GET /uk/company: $0.005 per call

UK company check from Companies House: search by ?q=name, or pass ?number=00445790 for the full profile: status, type, incorporation date, registered office, SIC codes, accounts and confirmation statement due dates (and whether overdue), charges, insolvency history and the number of active officers by role (no personal data). Official register data.

- **Price:** $0.005 in USDC, the same on Base, Solana, Polygon, Arbitrum. Failed calls are never charged.
- **Free trial:** yes, 20 free calls a day from Claude, Cursor or any MCP client ([set-up](/mcp/setup)).
- **Answers cached for:** 1 hour(s)
- **Data sources:** Companies House (free key, OGL)
- **Lane:** UK & EU open data ([OpenAPI](/openapi/uk-data.json))
- **Live health:** [status page](/status)

## Free sample

See an answer for the demo input first, free (no payment, 10 a minute): [https://aayatai.com/sample/uk-company](/sample/uk-company). It is a stored real answer when we have one, otherwise an example marked `"kind": "illustrative"`.

```bash
curl "https://aayatai.com/sample/uk-company"
```

## 1. See the price (free)

Call it without paying: you get `402 Payment Required` and a `PAYMENT-REQUIRED` header with the exact price and where to pay.

```bash
curl -i "https://aayatai.com/uk/company?number=00445790"
```

## 2. Pay and call (TypeScript)

```bash
npm install @x402/fetch @x402/evm viem
```

```ts
import { wrapFetchWithPaymentFromConfig } from "@x402/fetch";
import { ExactEvmScheme } from "@x402/evm";
import { privateKeyToAccount } from "viem/accounts";

// A wallet used only by your agent, holding a little USDC on Base.
const account = privateKeyToAccount(process.env.WALLET_PRIVATE_KEY as `0x${string}`);
const pay = wrapFetchWithPaymentFromConfig(fetch, {
  schemes: [{ network: "eip155:8453", client: new ExactEvmScheme(account) }],
});

const res = await pay("https://aayatai.com/uk/company?number=00445790");
console.log(await res.json());
```

## 3. Or as an MCP tool

```ts
// MCP server: https://aayatai.com/mcp (Streamable HTTP). With the x402 MCP client (see /start):
const result = await client.callTool("uk-company", {"number":"00445790"});
```

## Inputs

- `number` (string): Company number, e.g. 00445790 or SC123456.
- `q` (string): Company name to search for.

Bad inputs are rejected with HTTP 400 before any payment is asked for.

## Example answer

```json
{
  "company": {
    "name": "TESCO PLC",
    "number": "00445790",
    "status": "active",
    "type": "plc",
    "incorporated": "1947-11-27",
    "dissolved": null,
    "address": "Tesco House, Shire Park, Kestrel Way, Welwyn Garden City, AL7 1GA",
    "sicCodes": [
      "47110"
    ],
    "accounts": {
      "nextDue": "2026-08-24",
      "overdue": false,
      "lastMadeUpTo": "2025-02-22"
    },
    "confirmationStatement": {
      "nextDue": "2026-10-01",
      "overdue": false
    },
    "hasCharges": true,
    "hasInsolvencyHistory": false,
    "url": "https://find-and-update.company-information.service.gov.uk/company/00445790"
  },
  "officers": [
    {
      "role": "director",
      "count": 9
    },
    {
      "role": "secretary",
      "count": 1
    }
  ],
  "results": [],
  "licence": "Contains public sector information licensed under the Open Government Licence v3.0."
}
```

## Related

- [GET /uk/postcode](/services/uk-postcode) ($0.003): UK postcode lookup: coordinates, country, region, local authority, ward, parish, parliamentary constituency, LSOA/MSOA and official ONS codes.
- [GET /uk/area](/services/uk-area) ($0.01): UK area profile for a postcode or postcode district (e.g.
- [GET /uk/food-hygiene](/services/uk-food-hygiene) ($0.005): UK food hygiene ratings (Food Standards Agency) for restaurants, takeaways, shops and other food businesses: rating (0-5 or Pass/Improvement Required in Scotlan
- [GET /uk/house-prices](/services/uk-house-prices) ($0.01): Sold house prices for any England or Wales postcode from HM Land Registry Price Paid data (1995 to date): each sale's price, date, address, property type (detac
- [GET /uk/bank-holidays](/services/uk-bank-holidays) ($0.001): Official UK bank holidays (England & Wales, Scotland, Northern Ireland) from GOV.UK.
- [GET /eu/vat](/services/eu-vat) ($0.005): Check an EU VAT number live against the European Commission's VIES system: valid or not, and the registered company name and address where the member state shar
- [GET /eu/fx](/services/eu-fx) ($0.002): Official ECB euro foreign-exchange reference rates for about 30 currencies, converted to any base (GBP, USD, EUR...).
- [GET /eu/lei](/services/eu-lei) ($0.005): Look up legal entities in the global LEI register (GLEIF, 2.9M+ companies and funds worldwide): by LEI (with direct and ultimate parent companies), by name, or 

New here? [Getting started in 60 seconds](/start). All services: [Aayat AI](/).