# OneShot Agent API – Company Legal Entity Identifier (LEI) Lookup

> OneShot Agent API – Company Legal Entity Identifier (LEI) Lookup is a paid API for AI agents from win.oneshotagent.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-19).

Looks up a company's Legal Entity Identifier (LEI) record by LEI code or legal name, returning official registration details, addresses, status, and corroboration level.

## Facts

- Endpoint: POST https://win.oneshotagent.com/v1/tools/lookup/company-legal-identifier?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-19
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/oneshot-agent-api-company-legal-entity-identifier-lei-lookup-38edb6eb
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_XdOfLu6uA2obNc3RpY1UA

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability oneshot-agent-api-company-legal-entity-identifier-lei-lookup-38edb6eb -d '<json body>'
```

Example prompt: Can you look up the LEI record for Lockheed Martin Corporation — I need their official LEI code, registration status, jurisdiction, and headquarters address?

## When to prefer this

Use this endpoint when you need authoritative, GLEIF-sourced Legal Entity Identifier data for a company — particularly for KYC/KYB compliance, counterparty verification, regulatory reporting, or resolving a company's official legal identity. Prefer this over general company enrichment endpoints when the LEI code itself or jurisdiction/registration status is specifically required. It is especially useful when you already have an LEI and want to resolve it to a full record, or when you need corroboration-level data that generic business databases do not provide.

## Known failure modes

- No matching entity found for the given name or LEI — returns empty entities array with total 0
- LEI string is malformed or not 20 characters — may return validation error or empty result
- Name match returns multiple loosely similar entities requiring manual disambiguation
- Payment failure over x402 if USDC balance is insufficient — call is not executed
- Rate or network timeout if the GLEIF registry is temporarily unavailable

## How this service works

Look up the registered legal entities that match a company name or Legal Entity Identifier.

## Output

Returns a JSON object with a total count and an array of matching legal entities. Each entity includes the 20-character LEI, legal name, alternate names, jurisdiction, entity status (e.g. ACTIVE), registration status (e.g. ISSUED), corroboration level (e.g. FULLY_CORROBORATED), legal address, headquarters address, registration number, creation date, last updated date, and next renewal date.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "lei": {
   "type": "string",
   "description": "The Legal Entity Identifier, for example DPRBOZP0K5RM2YE8UU08. An exact match; preferred over a name. A Legal Entity Identifier is 20 letters and digits."
  },
  "name": {
   "type": "string",
   "description": "Legal name, for example Lockheed Martin Corporation. A text match: similarly named entities are returned too. 2 to 200 characters."
  },
  "limit": {
   "type": "integer",
   "description": "Most entities to return. From 1 to 10. Defaults to `5`."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "total": 1,
  "entities": [
   {
    "lei": "DPRBOZP0K5RM2YE8UU08",
    "created_on": "1994-08-29",
    "legal_name": "LOCKHEED MARTIN CORPORATION",
    "other_names": [],
    "jurisdiction": "US-MD",
    "corroboration": "FULLY_CORROBORATED",
    "entity_status": "ACTIVE",
    "legal_address": {
     "city": "BALTIMORE",
     "lines": [
      "C/O CSC-LAWYERS INCORPORATING SERVICE COMPANY",
      "7 ST. PAUL STREET",
      "SUITE 820"
     ],
     "region": "US-MD",
     "country": "US",
     "postal_code": "21202"
    },
    "registered_as": "D03964756",
    "registered_on": "2012-06-06",
    "last_updated_on": "2026-05-06",
    "legal_form_code": "HLR4",
    "next_renewal_on": "2027-05-29",
    "registration_status": "ISSUED",
    "headquarters_address": {
     "city": "BETHESDA",
     "lines": [
      "6801 ROCKLEDGE DR"
     ],
     "region": "US-MD",
     "country": "US",
     "postal_code": "20817"
    }
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/oneshot-agent-api-company-legal-entity-identifier-lei-lookup-38edb6eb/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from win.oneshotagent.com](https://www.zero.xyz/host/win.oneshotagent.com/llms.txt)