# GET /eu/lei: $0.005 per call

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 by national company number. Registered address, status, jurisdiction. Companies only.

- **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)).
- **Tier:** cached
- **Answers cached for:** 1 day(s)
- **Data sources:** GLEIF global LEI register (free, CC0)
- **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/eu-lei](/sample/eu-lei). It is a stored real answer when we have one, otherwise an example marked `"kind": "illustrative"`.

```bash
curl "https://aayatai.com/sample/eu-lei"
```

## 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/eu/lei?lei=2138002P5RNKC5W2JZ46"
```

## 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/eu/lei?lei=2138002P5RNKC5W2JZ46");
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("eu-lei", {"lei":"2138002P5RNKC5W2JZ46"});
```

## Inputs

- `lei` (string): 20-character LEI; returns the record and its parents.
- `q` (string): Legal name to search for.
- `registeredAs` (string): National company number, e.g. 00445790 (use with country).
- `country` (string): ISO country code to narrow a search, e.g. GB, DE.

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

## Example answer

```json
{
  "results": [
    {
      "lei": "2138002P5RNKC5W2JZ46",
      "name": "TESCO PLC",
      "otherNames": [],
      "status": "ACTIVE",
      "category": "GENERAL",
      "legalFormCode": "B6ES",
      "jurisdiction": "GB",
      "registeredAs": "00445790",
      "created": "1947-11-27",
      "address": "TESCO HOUSE, SHIRE PARK, KESTREL WAY, WELWYN GARDEN CITY, AL7 1GA, GB",
      "country": "GB",
      "registration": {
        "status": "ISSUED",
        "lastUpdate": "2025-11-21",
        "nextRenewal": "2027-01-10",
        "corroboration": "FULLY_CORROBORATED"
      },
      "url": "https://search.gleif.org/#/record/2138002P5RNKC5W2JZ46"
    }
  ],
  "parents": {
    "direct": null,
    "ultimate": null
  },
  "total": 1,
  "licence": "GLEIF data is available under CC0 1.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/company](/services/uk-company) ($0.005): UK company check from Companies House: search by ?q=name, or pass ?number=00445790 for the full profile: status, type, incorporation date, registered office, SI
- [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...).

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