{"uid":"cap_-vpA1Il9-8PsUkwITL893","slug":"lei-lookup-gleif-74abeba4","name":"LEI Lookup (GLEIF)","description":"Legal Entity Identifier (LEI) record from the GLEIF global index: legal name, status, jurisdiction, addresses, registration dates and direct and ultimate parents, as JSON.","url":"https://pennydatahq.com/api/lei/: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"},"pathParams":{"type":"object","required":["lei"],"properties":{"lei":{"type":"string","description":"20-character LEI (ISO 17442), any case. The check digits are verified."}}},"queryParams":{"type":"object","properties":{}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["lei","legal_name"],"properties":{"bic":{"type":"array","items":{"type":"string"}},"lei":{"type":"string"},"category":{"type":["string","null"],"description":"GENERAL, BRANCH, FUND, and others; sole traders are not served"},"legal_name":{"type":"string"},"other_names":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"type":{"type":["string","null"]}}}},"jurisdiction":{"type":["string","null"]},"registration":{"type":"object","properties":{"status":{"type":["string","null"],"description":"ISSUED, LAPSED, RETIRED, and others"},"last_update_date":{"type":["string","null"],"description":"YYYY-MM-DD"},"next_renewal_date":{"type":["string","null"],"description":"YYYY-MM-DD"},"corroboration_level":{"type":["string","null"]},"initial_registration_date":{"type":["string","null"],"description":"YYYY-MM-DD"}}},"direct_parent":{"type":["object","null"],"properties":{"lei":{"type":"string"},"country":{"type":["string","null"]},"legal_name":{"type":["string","null"]}},"description":"null when not reported"},"entity_status":{"type":["string","null"],"description":"ACTIVE or INACTIVE"},"legal_address":{"type":"object","properties":{"city":{"type":["string","null"]},"lines":{"type":"array","items":{"type":"string"}},"region":{"type":["string","null"],"description":"ISO 3166-2 code"},"country":{"type":["string","null"],"description":"ISO 3166-1 alpha-2"},"postal_code":{"type":["string","null"]}}},"registered_as":{"type":["string","null"],"description":"Number at the local business register"},"legal_form_code":{"type":["string","null"],"description":"ISO 20275 entity legal form code"},"ultimate_parent":{"type":["object","null"],"properties":{"lei":{"type":"string"},"country":{"type":["string","null"]},"legal_name":{"type":["string","null"]}},"description":"null when not reported"},"entity_creation_date":{"type":["string","null"],"description":"YYYY-MM-DD"},"headquarters_address":{"type":"object","properties":{"city":{"type":["string","null"]},"lines":{"type":"array","items":{"type":"string"}},"region":{"type":["string","null"],"description":"ISO 3166-2 code"},"country":{"type":["string","null"],"description":"ISO 3166-1 alpha-2"},"postal_code":{"type":["string","null"]}}}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_wBe-zhCiW20AGkicG2887","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves a Legal Entity Identifier (LEI) record from the GLEIF global index, returning legal name, status, jurisdiction, addresses, registration dates, and parent entity relationships as JSON.","exampleAgentPrompt":"Can you look up the LEI record for 7LTWFZYICNSX8D621K86 and tell me the legal name, entity status, jurisdiction, and who the direct parent company is?","exampleUseCases":[{"title":"KYC counterparty verification","prompt":"I need to verify the counterparty we're about to trade with — their LEI is 549300TRUWO2CD2G5692. Can you pull the full GLEIF record and confirm they're ACTIVE, tell me their legal address, and check if they have a reported ultimate parent?"},{"title":"Corporate ownership chain research","prompt":"Look up LEI 5493001KJTIIGC8Y1R12 for me — I want to know the legal entity name, what jurisdiction it's in, and who its direct and ultimate parent companies are according to the GLEIF index."},{"title":"Compliance LEI renewal check","prompt":"Can you check the LEI 213800WSGIIZCXF1P572 and tell me when it was last updated, when it's next due for renewal, and whether the registration status is still ISSUED?"}],"resultDescription":"A JSON object containing: the 20-character LEI, legal name, entity status (ACTIVE/INACTIVE), entity category (GENERAL, BRANCH, FUND, etc.), jurisdiction (country code), legal address and headquarters address (street lines, city, region, country), BIC codes, other names, registration details (status, initial registration date, last update date, next renewal date, corroboration level), direct parent LEI/name/country, and ultimate parent LEI/name/country. Parent fields are null when not reported.","failureModes":["Invalid LEI format or failed check digit validation — returns an error before querying GLEIF","LEI not found in GLEIF index — 404 or empty result","LEI exists but entity is LAPSED or RETIRED — data returned but entity_status reflects inactive state","GLEIF upstream unavailability — may return 5xx or timeout","Truncated parent data if the entity has not reported parent relationships (null fields rather than error)"],"whenToPreferThis":"Use this endpoint when you have a known LEI code and need structured entity data from the authoritative GLEIF global registry — especially for compliance, KYC, financial counterparty checks, or corporate ownership research. It covers all GLEIF-registered entities globally (not just UK), making it broader than Companies House lookups. Prefer it over general web search when you need machine-readable, authoritative registration data including parent relationships and renewal status.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:39:48.047Z","isFirstParty":false,"canonicalSlug":"lei-lookup-gleif-74abeba4"}