{"uid":"cap_ryCSHuBoX80V3zvHHsTcu","slug":"verif-entreprise-fr-lei-registry-lookup-gleif-3e7c4c74","name":"Verif Entreprise FR – LEI Registry Lookup (GLEIF)","description":"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.","url":"https://api-production-24833.up.railway.app/v1/lei?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"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":"object"}}},"groupe":{"type":["object","null"]},"signaux":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"date":{"type":["string","null"]},"niveau":{"type":"string"},"preuve":{"type":["string","null"]},"source":{"type":"string"},"message":{"type":"string"}}}},"fraicheur":{"enum":["temps_reel","cache","degradee"],"type":"string"},"verifieLe":{"type":"string"},"attestation":{"type":"object"},"correspondances":{"type":["number","null"]},"rapprochementFr":{"type":["object","null"]},"enregistrementLei":{"type":"object","properties":{"emisLe":{"type":["string","null"]},"statut":{"type":["string","null"]},"misAJourLe":{"type":["string","null"]},"corroboration":{"type":["string","null"]},"renouvellementLe":{"type":["string","null"]}}}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_LLOmwyzdojLq0Ym2O11G2","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"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.","exampleAgentPrompt":"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?","exampleUseCases":[{"title":"Supplier onboarding identity check","prompt":"Before we onboard this German supplier, can you look them up in the GLEIF LEI registry using their LEI 529900T8BM49AURSDO55 and tell me their legal name, registration status, registered address, and who their ultimate parent is?"},{"title":"SIREN to LEI corporate group resolution","prompt":"I have a French company with SIREN 552032534 — can you find their LEI record in the GLEIF database and show me their direct and ultimate parent companies?"},{"title":"Lapsed LEI counterparty verification","prompt":"We're reviewing a counterparty with LEI 549300MLUDYVRQOOXS22 — can you check the official GLEIF registry and tell me whether their LEI is still active and when it was last renewed?"}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-16T18:31:30.441Z","isFirstParty":false,"canonicalSlug":"verif-entreprise-fr-lei-registry-lookup-gleif-3e7c4c74"}