{"uid":"cap_EL7gsJQVl2CfN3cNuYl0e","slug":"gleif-lei-entity-search-37c1bfea","name":"GLEIF LEI Entity Search","description":"Search the official GLEIF Global LEI Index by exact LEI or legal name and return ranked legal-entity identity, registration, mapped-identifier, and relationship-availability evidence.","url":"https://apiacre.com/v1/research/lei-entity-search","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"lei":{"anyOf":[{"type":"string"},{"type":"null"}]},"legal_name":{"anyOf":[{"type":"string"},{"type":"null"}]},"max_results":{"type":"integer"},"country_code":{"anyOf":[{"type":"string"},{"type":"null"}]}}},"responseSchema":{"type":"json","example":{"data":{"query":{"mode":"legal_name","value":"Apple Inc.","maxResults":3,"countryCode":"US"},"source":"https://api.gleif.org/api/v1/lei-records","status":"matched","license":{"id":"CC0-1.0","url":"https://creativecommons.org/publicdomain/zero/1.0/","termsUrl":"https://www.gleif.org/en/meta/lei-data-terms-of-use/"},"matches":[{"lei":"HWUPKR0MPOU8FGXBT394","match":{"type":"exact","score":1},"legalName":"Apple Inc.","otherNames":[{"name":"Apple Computer, Inc.","type":"PREVIOUS_LEGAL_NAME","language":"en"}],"legalAddress":{"city":"Glendale","region":"US-CA","country":"US","postalCode":"91203","addressLines":["C/O C T Corporation System","330 N. Brand Blvd"]}}],"disclaimer":"Official public LEI reference data normalized from GLEIF. Corroborate name ma...","matchCount":1,"limitations":["Name-match scores rank candidates but do not establish identity.","Not every legal entity has an LEI, and source records may be stale or incompl...","Relationship flags indicate available GLEIF links; they do not expand the rel..."],"retrievedAt":"2026-08-11T08:30:00+00:00","totalCandidates":20,"goldenCopyPublishedAt":"2026-08-11T00:00:00Z"},"meta":{"cached":false,"sources":[],"warnings":[],"duration_ms":42,"next_actions":[{"path":"/v1/research/organization-evidence","title":"Official supplier evidence report","method":"POST","reason":"Expand a selected GLEIF candidate with independent USAspending, SEC filing-ac...","service":"research.organization-evidence"}]},"service":"research.lei-entity-search","version":"1","request_id":"018f1f54-7f38-7ba2-8dc3-5f90272d9f1a"}},"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_jr9LJN9Rk5RrtunwZ3t-p","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":"Search the GLEIF Global LEI Index by exact LEI code or legal name to retrieve ranked legal entity identity, registration, mapped-identifier, and relationship-availability evidence.","exampleAgentPrompt":"Can you search the GLEIF LEI index for 'Deutsche Bank AG' and give me their LEI code, registration status, and any relationship or mapped-identifier data?","exampleUseCases":[{"title":"KYB counterparty LEI verification","prompt":"We're onboarding a new institutional client called 'Barclays Bank PLC' — can you pull their LEI from the GLEIF index and confirm the registration is active, along with any mapped identifiers?"},{"title":"Compliance LEI code validation","prompt":"I have this LEI code — 7H6GLXDRUGQFU57RNE97 — can you look it up in the GLEIF database and tell me what legal entity it belongs to and whether the registration is current?"},{"title":"Parent entity relationship lookup","prompt":"Can you search the GLEIF index for 'Goldman Sachs International' and check whether there's parent or ultimate-parent relationship data available for them?"}],"resultDescription":"Returns ranked results from the GLEIF Global LEI Index including legal entity identity fields (legal name, jurisdiction, entity status), LEI registration metadata (registration status, initial/last update dates), mapped identifiers (BIC, ISIN linkages), and flags indicating availability of relationship (parent/child) data. Results are ordered by relevance to the input query.","failureModes":["No matching entity found for the provided name or LEI — returns empty results","LEI code format invalid or malformed — returns validation error","GLEIF index temporarily unavailable — upstream timeout or 5xx error","Ambiguous legal name matches multiple entities — returns multiple ranked candidates requiring disambiguation","Rate limit exceeded or payment failure — returns 402 or 429 error"],"whenToPreferThis":"Choose this endpoint when you need authoritative, GLEIF-sourced legal entity identification — especially for financial compliance, KYC/KYB workflows, counterparty validation, or regulatory reporting. It is preferable over generic company search APIs when you need LEI codes specifically, registration status, mapped financial identifiers (BIC/ISIN), or parent-entity relationship flags backed by the official global LEI registry.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:39:39.420Z","isFirstParty":false}