{"uid":"cap_M9WHTkvfj3q-kkKp9tBOH","slug":"gleif-lei-search-via-x402-atlas-229a89d8","name":"GLEIF LEI Search via X402 Atlas","description":"Search global company legal names in GLEIF to find Legal Entity Identifiers (LEIs), jurisdictions and registration status. Up to ten results per paid page support entity disambiguation, counterparty matching and reference-data enrichment.","url":"https://legal-entities.use.x402atlas.com/search?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"type":"object","required":["query"],"properties":{"page":{"type":"integer","default":1,"maximum":100,"minimum":1,"description":"Page number, starting at one."},"query":{"type":"string","maxLength":120,"minLength":2,"description":"Legal company name, 2..120 UTF-8 bytes; letters/digits/spaces and . & apostrophes ( ) - only; no '..' or filter operators. Empty/omitted query or body returns the fixed paid sample; page does not change it."}},"additionalProperties":false},"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","required":["entities","has_more","operation","page","page_size","parents","schema_version","total"],"properties":{"page":{"type":"integer","maximum":100,"minimum":1,"description":"Requested search page; 1 for lookup."},"total":{"type":"integer","minimum":0,"description":"Total matching entities; 1 for lookup."},"parents":{"type":"array","items":{"type":"object","required":["kind","records","state"],"properties":{"kind":{"enum":["direct","ultimate"],"type":"string","description":"Accounting-consolidation parent kind."},"state":{"enum":["relationship","reporting-exception","not-reported"],"type":"string","description":"Not-reported means no parent relationship or reporting exception was supplied."},"records":{"type":"array","items":{"type":"object","required":["last_updated","parent_id","parent_id_type","reason","reference","registration_status","relationship_status","valid_from","valid_to"],"properties":{"reason":{"type":["string","null"],"description":"Reporting-exception reason; null for a relationship."},"valid_to":{"type":["string","null"],"description":"Validity end timestamp; null if not reported."},"parent_id":{"type":["string","null"],"description":"Reported parent identifier, null for exception; interpret together with parent_id_type."},"reference":{"type":["string","null"],"description":"Reporting-exception reference; null if not reported."},"valid_from":{"type":["string","null"],"description":"Validity start timestamp; null if not reported."},"last_updated":{"type":["string","null"],"description":"Relationship update timestamp; null for exception."},"parent_id_type":{"type":["string","null"],"description":"Identifier type, such as LEI; null for exception."},"registration_status":{"type":["string","null"],"description":"Relationship registration status, null for exception."},"relationship_status":{"type":["string","null"],"description":"Relationship status; null for exception."}},"additionalProperties":false},"maxItems":10,"description":"Parent records; empty when not-reported."}},"additionalProperties":false},"maxItems":2,"description":"Direct then ultimate parent states; empty for other operations."},"entities":{"type":"array","items":{"type":"object","required":["country","entity_status","jurisdiction","last_updated","legal_name","lei","next_renewal","registration_id","registration_status"],"properties":{"lei":{"type":"string","description":"20-character Legal Entity Identifier."},"country":{"type":"string","description":"Legal address country code."},"legal_name":{"type":"string","description":"Official entity legal name."},"jurisdiction":{"type":"string","description":"Legal jurisdiction."},"last_updated":{"type":"string","description":"LEI record update timestamp."},"next_renewal":{"type":["string","null"],"description":"Next LEI renewal timestamp; null if not reported."},"entity_status":{"type":"string","description":"Entity status, separate from LEI renewal."},"registration_id":{"type":["string","null"],"description":"Local registration identifier; null if not reported."},"registration_status":{"type":"string","description":"LEI registration status, such as ISSUED or LAPSED."}},"additionalProperties":false},"maxItems":10,"description":"One entity for lookup/parents; one bounded search page, possibly empty."},"has_more":{"type":"boolean","description":"Further matches exist; pages 1–100 are supported."},"operation":{"enum":["search"],"type":"string","description":"Endpoint operation."},"page_size":{"enum":[10],"type":"integer","description":"Fixed at 10 for search; 1 for entity and parent-company lookup."},"schema_version":{"enum":["1"],"type":"string","description":"Normalized contract version."}},"additionalProperties":false}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","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_9Q2Ebzhcp1Dco9edn5uNl","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Searches the Global LEI Foundation (GLEIF) registry by company legal name to return up to 10 matching Legal Entity Identifiers (LEIs), jurisdictions, and registration statuses per page.","exampleAgentPrompt":"Search the GLEIF registry for the legal entity 'Deutsche Bank AG' and give me its LEI code, jurisdiction, and current registration status — show up to 10 results so I can pick the right entity if there are multiple matches.","exampleUseCases":[{"title":"Counterparty LEI matching for trade settlement","prompt":"I need to confirm the LEI code for 'Barclays Bank PLC' before we book this trade — can you search GLEIF and pull back its LEI, jurisdiction, and whether it's currently active?"},{"title":"KYC reference data enrichment","prompt":"We're onboarding 'Société Générale S.A.' as a new client — look them up in the GLEIF registry and get me their official LEI and registration status for our compliance records."},{"title":"Disambiguating similarly named entities","prompt":"There are several companies called 'Apex Capital' in our system — search GLEIF for that name and show me up to 10 results with their LEIs and jurisdictions so I can figure out which one is our counterparty."}],"resultDescription":"Returns a paginated list of up to 10 legal entity records matching the search query, each including the LEI code, official legal name, jurisdiction of registration, and current registration/validation status as recorded in the GLEIF global registry.","failureModes":["No matching entities found for an obscure or misspelled company name","Multiple similarly named entities returned requiring manual disambiguation","GLEIF registry data may be stale if an entity recently changed status","Payment failure if USDC balance is insufficient for the $0.01 call cost","Rate limiting or service unavailability from the upstream GLEIF API"],"whenToPreferThis":"Prefer this endpoint when you need authoritative, globally standardized Legal Entity Identifier data from the official GLEIF registry, particularly for financial compliance, KYC, counterparty matching, or reference data enrichment workflows. It is especially valuable when disambiguating companies with similar names across multiple jurisdictions. Use it over generic company search APIs when LEI codes and formal registration status are required outputs.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-18T18:38:12.447Z","isFirstParty":false,"canonicalSlug":"gleif-lei-search-via-x402-atlas-229a89d8"}