HTTP/1.1 402 PAYMENT REQUIRED agent402.base.eth · BASE · SOLANA · POLYGON · ARBITRUM · MONAD · STELLAR · ALGORAND · ROBINHOOD · USDC · USDG
Agent402 / tools / lei-lookup

Legal entity (LEI) lookup

$0.01 per call · USDC via x402 · POST /api/lei-lookup

Look up a legal entity in the official GLEIF registry. Pass a 20-character LEI for the full record — legal name, jurisdiction, legal form, addresses, registration status, and the reported direct + ultimate parent entities — or pass a company name to fulltext-search the registry and get ranked candidate LEIs. Unknown LEIs return {found:false}; parents that aren't reported return null. Official registry data, keyless.

Input

FieldTypeDescription
leistring20-character alphanumeric Legal Entity Identifier (exact record lookup).
namestringCompany name to fulltext-search instead (ranked candidate list). Provide lei OR name.

Example output

{
  "found": true,
  "record": {
    "lei": "HWUPKR0MPOU8FGXBT394",
    "legalName": "APPLE INC.",
    "jurisdiction": "US-CA",
    "entityStatus": "ACTIVE",
    "legalAddress": {
      "city": "Cupertino",
      "region": "US-CA",
      "country": "US"
    },
    "registration": {
      "status": "ISSUED",
      "nextRenewal": "2026-10-13T00:31:58Z"
    }
  },
  "parents": {
    "direct": null,
    "ultimate": null
  },
  "source": "api.gleif.org"
}

Try it — see the 402 challenge (free)

curl -i -X POST https://agent402.tools/api/lei-lookup \
  -H "Content-Type: application/json" \
  -d '{"lei":"HWUPKR0MPOU8FGXBT394"}'

The response is HTTP 402 Payment Required with exact payment requirements. Any x402 v2 client pays automatically and retries:

Paid call (JavaScript agent)

import { wrapFetchWithPayment } from "@x402/fetch";
import { x402Client } from "@x402/core/client";
import { registerExactEvmScheme } from "@x402/evm/exact/client";
import { privateKeyToAccount } from "viem/accounts";

const client = new x402Client();
registerExactEvmScheme(client, { signer: privateKeyToAccount(KEY) });
const payFetch = wrapFetchWithPayment(fetch, client);

const res = await payFetch("https://agent402.tools/api/lei-lookup", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    "lei": "HWUPKR0MPOU8FGXBT394"
  }),
});
Wallet-only. This tool reaches the network/browser/storage, so it is paid in USDC via x402 (no proof-of-work tier).

Part of these workflows

This tool is one step in a curated multi-tool workflow — agents can fetch the whole sequence as an MCP prompt or call https://agent402.tools/api/skill-packs/{slug}/prompt.

Related tools

US gov dataset search

$0.003 · GET /api/gov-data

Search 300,000+ US government datasets on catalog.data.gov (CKAN): titles, publishing org, formats, and direct resource …

US weather alerts

$0.003 · GET /api/weather-alerts

Active National Weather Service alerts for a US state as clean JSON: event, severity, headline, affected areas, onset/ex…

Recent earthquakes (USGS)

$0.003 · GET /api/earthquakes

Real-time USGS earthquake feed: magnitude, place, time, depth, coordinates. Live government data, no key. ?minMag=4.5&pe…