# Verif Entreprise FR – LEI Registry Lookup (GLEIF)

> Verif Entreprise FR – LEI Registry Lookup (GLEIF) is a paid API for AI agents from api-production-24833.up.railway.app, paid per call via x402, $0.01/call, status unknown (last checked 2026-11-16).

Looks up a legal entity in the official GLEIF LEI registry by LEI code or national registration number (e.g. French SIREN), returning legal name, status, registered address, registration dates, and corporate group structure.

## Facts

- Endpoint: GET https://api-production-24833.up.railway.app/v1/lei?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/verif-entreprise-fr-lei-registry-lookup-gleif-3e7c4c74
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ryCSHuBoX80V3zvHHsTcu

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 verif-entreprise-fr-lei-registry-lookup-gleif-3e7c4c74
```

Example prompt: Can you look up the GLEIF LEI registry for the company with LEI 969500T3MBS4SQAMHJ45 and tell me its legal name, active status, registered address, and ultimate parent?

## When to prefer this

Use this endpoint when you need authoritative, registry-sourced identity data for a legal entity using its LEI or a national registration number like a French SIREN. Prefer this over company name searches or commercial databases when you need ISO 17442-compliant LEI data with corporate group (parent) chain, especially for KYB/KYC onboarding, counterparty due diligence, or financial compliance workflows. The GLEIF registry is the official global source for LEI data and covers entities worldwide.

## Known failure modes

- LEI not found in GLEIF registry — returns empty or error response
- Invalid LEI format (not 20 alphanumeric characters) — schema validation error
- SIREN not matched to any LEI record — returns null or zero correspondances
- Country code not recognised or missing when using immatriculation lookup — query rejected
- GLEIF upstream unavailable — degraded freshness mode or error returned
- Sole proprietor entity requested — excluded by design, no personal data returned

## How this service works

LEI lookup (GLEIF): find a legal entity in the official GLEIF LEI registry (CC0) by LEI or by national registration number (e.g. French SIREN). Use it to identify a foreign supplier, customer or counterparty and its corporate group before onboarding. Returns legal name, status, registered address, registration and renewal dates, direct and ultimate parent, and explained signals. Sole proprietors are excluded, no personal data. Errors are never charged.

## Output

Returns a structured record including: the 20-character LEI, entity legal name, entity status (active/lapsed/etc.), registered address, jurisdiction, legal form, national registration number, registration and renewal dates, direct parent LEI and name, ultimate parent LEI and name, and an array of explained signals with severity levels (e.g. lapsed renewal, missing parent data). Also includes a data freshness indicator (real-time, cached, or degraded) and a verification timestamp.

## 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"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "lei": {
       "type": "string",
       "pattern": "^[A-Za-z0-9]{20}$",
       "description": "20-character LEI (ISO 17442, check digits verified). Exclusive with pays."
      },
      "pays": {
       "type": "string",
       "pattern": "^[A-Za-z]{2}$",
       "description": "ISO 3166-1 alpha-2 country of the registered office, used with immatriculation."
      },
      "parents": {
       "enum": [
        "oui",
        "non"
       ],
       "type": "string",
       "description": "non skips the direct and ultimate parent lookups (default oui)."
      },
      "immatriculation": {
       "type": "string",
       "maxLength": 40,
       "minLength": 3,
       "description": "National registration number (a SIREN for FR), used with pays instead of lei."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "lei",
      "entite",
      "enregistrementLei",
      "signaux"
     ],
     "properties": {
      "lei": {
       "type": "string"
      },
      "entite": {
       "type": "object",
       "properties": {
        "pays": {
         "type": [
          "string",
          "null"
         ]
        },
        "creeLe": {
         "type": [
          "string",
          "null"
         ]
        },
        "statut": {
         "type": [
          "string",
          "null"
         ]
        },
        "categorie": {
         "type": [
          "string",
          "null"
         ]
        },
        "juridiction": {
         "type": [
          "string",
          "null"
         ]
        },
        "adresseSiege": {
         "type": "object"
        },
        "raisonSociale": {
         "type": [
          "string",
          "null"
         ]
        },
        "formeJuridique": {
         "type": [
          "object",
          "null"
         ]
        },
        "immatriculation": {
         "type": "ob
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/verif-entreprise-fr-lei-registry-lookup-gleif-3e7c4c74/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api-production-24833.up.railway.app](https://www.zero.xyz/host/api-production-24833.up.railway.app/llms.txt)
