# Vextorium LEI Search

> Vextorium LEI Search is a paid API for AI agents from api.vextorium.com, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-10).

Look up a company's LEI (Legal Entity Identifier) by name, or retrieve full LEI record details by LEI code, including legal name, country, address, entity status, and parent info.

## Facts

- Endpoint: POST https://api.vextorium.com/v1/lei-search?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-10
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/vextorium-lei-search-895352fe
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_MRXmPJ-j-MnfaYVbRtVuh

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 vextorium-lei-search-895352fe -d '<json body>'
```

Example prompt: Can you find the LEI for HSBC Holdings and tell me its legal status, registered country, and next renewal date?

## When to prefer this

Use this endpoint when you need to resolve a Legal Entity Identifier (LEI) for regulatory, compliance, KYC, or financial reporting purposes. It is ideal for agents that need to identify legal entities unambiguously, verify their status, or enrich corporate data with GLEIF-sourced registry information. Prefer this over generic company search APIs when the LEI code or GLEIF-standardized entity data is specifically required.

## Known failure modes

- No matching entities found for an obscure or misspelled company name — returns empty entities array
- Invalid or non-existent LEI code — may return empty or null result
- Ambiguous company name matches many entities — result set may need filtering by country or status
- GLEIF data may be stale if the company hasn't renewed its LEI — renewal date field helps detect this
- Rate limiting or payment failure (x402) may cause request rejection

## How this service works

Find a company's LEI (Legal Entity Identifier) by name, or the record of a LEI: legal name, country, legal form, address, entity and registration status, renewal date, direct parent and company register number.

## Output

Returns a JSON object with the search term used, the data source (GLEIF, CC0), and an array of matching entities. Each entity includes: LEI code, legal name, city, full address, country code, legal form code, next renewal date, direct matrix (parent) if any, entity status (e.g. ACTIVE), record status (e.g. ISSUED), and commercial registry number.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "required": [],
     "properties": {
      "lei": {
       "type": "string"
      },
      "limit": {
       "type": "integer"
      },
      "company": {
       "type": "string"
      }
     }
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": [
      "object",
      "null"
     ],
     "properties": {
      "search": {
       "type": [
        "string",
        "null"
       ]
      },
      "source": {
       "type": [
        "string",
        "null"
       ]
      },
      "entities": {
       "type": [
        "array",
        "null"
       ],
       "items": {
        "type": [
         "null",
         "object"
        ],
        "properties": {
         "lei": {
          "type": [
           "null",
           "string"
          ]
         },
         "city": {
          "type": [
           "null",
           "string"
          ]
         },
         "name": {
          "type": [
           "null",
           "string"
          ]
         },
         "address": {
          "type": [
           "null",
           "string"
          ]
         },
         "country": {
          "type": [
           "null",
           "string"
          ]
         },
         "legal_form": {
          "type": [
           "null",
           "string"
          ]
         },
         "next_renewal": {
          "type": [
           "null",
           "string"
          ]
         },
         "direct_matrix": {},
         "entity_status": {
          "type": [
           "null",
           "string"
          ]
         },
         "record_status": {
          "type": [
           "null",
           "string"
          ]
         },
         "commercial_registry": {
          "type": [
           "null",
           "string"
          ]
         }
        }
       }
      }
     }
    }

… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "search": "Telefonica",
  "source": "GLEIF (Global LEI Foundation, CC0)",
  "entities": [
   {
    "lei": "549300EEJH4FEPDBBR25",
    "city": "MADRID",
    "name": "TELEFONICA SA",
    "address": "GRAN VIA 28",
    "country": "ES",
    "legal_form": "5RDO",
    "next_renewal": "2027-10-01",
    "direct_matrix": null,
    "entity_status": "ACTIVE",
    "record_status": "ISSUED",
    "commercial_registry": "A28015865"
   },
   {
    "lei": "815600194E0319B50518",
    "city": "LAMEZIA TERME",
    "name": "TELEFONICA GROUP S.R.L.",
    "address": "ZONA INDUSTRIALE INDUSTRIALE AREA EX SIR, SNC",
    "country": "IT",
    "legal_form": "OV32",
    "next_renewal": "2027-10-25",
    "direct_matrix": null,
    "entity_status": "ACTIVE",
    "record_status": "ISSUED",
    "commercial_registry": "03038920793"
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/vextorium-lei-search-895352fe/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.vextorium.com](https://www.zero.xyz/host/api.vextorium.com/llms.txt)