{"uid":"cap_XdOfLu6uA2obNc3RpY1UA","slug":"oneshot-agent-api-company-legal-entity-identifier-lei-lookup-38edb6eb","name":"OneShot Agent API – Company Legal Entity Identifier (LEI) Lookup","description":"Look up the registered legal entities that match a company name or Legal Entity Identifier.","url":"https://win.oneshotagent.com/v1/tools/lookup/company-legal-identifier?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"lei":{"type":"string","description":"The Legal Entity Identifier, for example DPRBOZP0K5RM2YE8UU08. An exact match; preferred over a name. A Legal Entity Identifier is 20 letters and digits."},"name":{"type":"string","description":"Legal name, for example Lockheed Martin Corporation. A text match: similarly named entities are returned too. 2 to 200 characters."},"limit":{"type":"integer","description":"Most entities to return. From 1 to 10. Defaults to `5`."}}},"responseSchema":{"type":"json","example":{"total":1,"entities":[{"lei":"DPRBOZP0K5RM2YE8UU08","created_on":"1994-08-29","legal_name":"LOCKHEED MARTIN CORPORATION","other_names":[],"jurisdiction":"US-MD","corroboration":"FULLY_CORROBORATED","entity_status":"ACTIVE","legal_address":{"city":"BALTIMORE","lines":["C/O CSC-LAWYERS INCORPORATING SERVICE COMPANY","7 ST. PAUL STREET","SUITE 820"],"region":"US-MD","country":"US","postal_code":"21202"},"registered_as":"D03964756","registered_on":"2012-06-06","last_updated_on":"2026-05-06","legal_form_code":"HLR4","next_renewal_on":"2027-05-29","registration_status":"ISSUED","headquarters_address":{"city":"BETHESDA","lines":["6801 ROCKLEDGE DR"],"region":"US-MD","country":"US","postal_code":"20817"}}]}},"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_KeyviGq4Rx0SfysVlpjuN","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":"Looks up a company's Legal Entity Identifier (LEI) record by LEI code or legal name, returning official registration details, addresses, status, and corroboration level.","exampleAgentPrompt":"Can you look up the LEI record for Lockheed Martin Corporation — I need their official LEI code, registration status, jurisdiction, and headquarters address?","exampleUseCases":[{"title":"KYB compliance check for onboarding","prompt":"I need to verify the legal entity details for HSBC Holdings plc before we onboard them — can you look up their LEI, confirm it's active and fully corroborated, and get me their registered jurisdiction and address?"},{"title":"Resolving a company LEI from a known code","prompt":"I have an LEI code — DPRBOZP0K5RM2YE8UU08 — can you pull the full company record for it, including the legal name, status, and any alternate names?"},{"title":"Finding similar legal entities by name","prompt":"Can you search for legal entities named 'Goldman Sachs' and return up to 10 results with their LEI codes and registration statuses so I can find the right entity?"}],"resultDescription":"Returns a JSON object with a total count and an array of matching legal entities. Each entity includes the 20-character LEI, legal name, alternate names, jurisdiction, entity status (e.g. ACTIVE), registration status (e.g. ISSUED), corroboration level (e.g. FULLY_CORROBORATED), legal address, headquarters address, registration number, creation date, last updated date, and next renewal date.","failureModes":["No matching entity found for the given name or LEI — returns empty entities array with total 0","LEI string is malformed or not 20 characters — may return validation error or empty result","Name match returns multiple loosely similar entities requiring manual disambiguation","Payment failure over x402 if USDC balance is insufficient — call is not executed","Rate or network timeout if the GLEIF registry is temporarily unavailable"],"whenToPreferThis":"Use this endpoint when you need authoritative, GLEIF-sourced Legal Entity Identifier data for a company — particularly for KYC/KYB compliance, counterparty verification, regulatory reporting, or resolving a company's official legal identity. Prefer this over general company enrichment endpoints when the LEI code itself or jurisdiction/registration status is specifically required. It is especially useful when you already have an LEI and want to resolve it to a full record, or when you need corroboration-level data that generic business databases do not provide.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-19T06:39:44.188Z","isFirstParty":false,"canonicalSlug":"oneshot-agent-api-company-legal-entity-identifier-lei-lookup-38edb6eb"}