{"openapi":"3.1.0","info":{"title":"Legal Entity Identifier (LEI) Lookup","version":"0.1.0","description":"Authoritative legal-entity identity via the Legal Entity Identifier (LEI): resolve an LEI to its name, status, jurisdiction and address, search by legal name, or retrieve direct and ultimate accounting-consolidating parents with reporting exceptions. Global CC0 registry data for counterparty diligence.","x-guidance":"Authoritative legal-entity identity via the Legal Entity Identifier (LEI): resolve an LEI to its name, status, jurisdiction and address, search by legal name, or retrieve direct and ultimate accounting-consolidating parents with reporting exceptions. Global CC0 registry data for counterparty diligence. Each operation is an HTTP POST to its /v1/<operation> path with a JSON request body (see each operation's requestBody schema) and returns a JSON response. Endpoints are paid per successful call via x402 or MPP (USDC on Base); an unpaid request returns 402 with payment metadata in the WWW-Authenticate header.","contact":{"email":"hello@openverbs.com"}},"x-discovery":{"ownershipProofs":["0xb1401a71756f51464a9962db12f1eb3e9522490cd20010b06d00cf7b7770acfd5f79721f9dfdf2643f8cecd29af3bde9ec133941a386042b32d9886053a70de61b","0xc1c1f11793e18a00fcb7072421f26e89fb75b6aa517fa84370564991f4b10efa024f6f57e4e67eefd20cf46cc01fc5a62d793fa8fbcda04f26c946a3433d73f91b","0x676b474af0ef9ed4809b5d12d2e789b36e52d56215b21f601d71f76620e36ec630347116a7b2b349a3c3681e5db0fbfa76c4169a676b6d6f27864d0e5017284a1c","0xc2ab96522515ed9e9bc4f1a241b774bd48df42e951ddbf7f6aa8fc76f5a96a20421703e1ec402ce7eb1e4eabea3b6e4e4129cf39d56ea91cf4fcf38561fc94fc1c"]},"servers":[{"url":"https://gleif.openverbs.com"}],"paths":{"/health":{"get":{"summary":"Health check","security":[],"responses":{"200":{"description":"Healthy","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"service":{"type":"string"},"version":{"type":"string"}}}}}}}}},"/v1/lookup":{"post":{"summary":"Look up a legal entity by LEI","description":"Resolve a 20-character Legal Entity Identifier (LEI, ISO 17442) to its authoritative entity record: verified legal name, registration status (ISSUED/LAPSED/RETIRED), entity status, jurisdiction, legal form, registration number, legal and headquarters addresses, key dates (registration, last update, next renewal), managing LOU, corroboration level and any BIC codes. ISO 7064 check digits are verified before payment. Paid endpoint (x402 + MPP). Price: $0.006000 USDC per successful payment.","tags":["lei lookup api","legal entity identifier lookup","verify company lei","kyc entity lookup","gleif registration status"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"lei":{"type":"string","minLength":20,"maxLength":20,"description":"20-character alphanumeric Legal Entity Identifier (ISO 17442), e.g. \"5493001KJTIIGC8Y1R12\"."}},"required":["lei"],"additionalProperties":false},"example":{"lei":"5493001KJTIIGC8Y1R12"}}}},"responses":{"200":{"description":"`{ lei, found, legalName, registrationStatus, entityStatus, jurisdiction, legalForm, registeredAs, category, country, legalAddress, headquartersAddress, initialRegistrationDate, lastUpdateDate, nextRenewalDate, managingLou, corroborationLevel, bic, source, stale, cachedAt? }`.","content":{"application/json":{"schema":{"type":"object","description":"`{ lei, found, legalName, registrationStatus, entityStatus, jurisdiction, legalForm, registeredAs, category, country, legalAddress, headquartersAddress, initialRegistrationDate, lastUpdateDate, nextRenewalDate, managingLou, corroborationLevel, bic, source, stale, cachedAt? }`."}}}},"400":{"description":"Invalid request; no payment is attempted"},"402":{"description":"Payment required; x402/MPP metadata returned in headers"},"502":{"description":"Upstream provider error after payment verification"}},"x-payment-info":{"amount":"6000","currency":"0x20c000000000000000000000b9537d11c60e8b50","description":"Resolve a 20-character Legal Entity Identifier (LEI, ISO 17442) to its authoritative entity record: verified legal name, registration status (ISSUED/LAPSED/RETIRED), entity status, jurisdiction, legal form, registration number, legal and headquarters addresses, key dates (registration, last update, next renewal), managing LOU, corroboration level and any BIC codes. ISO 7064 check digits are verified before payment.","method":"tempo","preferredOffer":"mpp-tempo","price":{"mode":"fixed","currency":"USD","amount":"0.006000"},"protocols":[{"x402":{"scheme":"exact","network":"eip155:8453","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A"}},{"mpp":{"method":"evm","intent":"charge","network":"8453","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A"}},{"mpp":{"method":"tempo","intent":"charge","network":"4217","currency":"0x20c000000000000000000000b9537d11c60e8b50","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A"}}],"network":"4217","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A","offers":[{"amount":"6000","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","description":"Resolve a 20-character Legal Entity Identifier (LEI, ISO 17442) to its authoritative entity record: verified legal name, registration status (ISSUED/LAPSED/RETIRED), entity status, jurisdiction, legal form, registration number, legal and headquarters addresses, key dates (registration, last update, next renewal), managing LOU, corroboration level and any BIC codes. ISO 7064 check digits are verified before payment.","intent":"charge","method":"evm","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A"},{"amount":"6000","currency":"0x20c000000000000000000000b9537d11c60e8b50","description":"Resolve a 20-character Legal Entity Identifier (LEI, ISO 17442) to its authoritative entity record: verified legal name, registration status (ISSUED/LAPSED/RETIRED), entity status, jurisdiction, legal form, registration number, legal and headquarters addresses, key dates (registration, last update, next renewal), managing LOU, corroboration level and any BIC codes. ISO 7064 check digits are verified before payment.","intent":"charge","method":"tempo","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A"}]}}},"/v1/search":{"post":{"summary":"Search entities by legal name","description":"Find Legal Entity Identifiers by legal name, optionally filtered to an ISO 3166-1 alpha-2 country. Returns matching entities with their LEI, verified legal name, registration status, jurisdiction and city/country - the reverse of lookup, for when you have a company name but need its authoritative LEI and legal identity. Paid endpoint (x402 + MPP). Price: $0.006000 USDC per successful payment.","tags":["search legal entities","company lei search","find lei by name","gleif entity search","legal name registry lookup"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":2,"maxLength":200,"description":"Legal name (or a distinctive part of it) to search for, e.g. \"Bloomberg Finance\"."},"country":{"type":"string","minLength":2,"maxLength":2,"description":"Optional ISO 3166-1 alpha-2 country code of the legal address, e.g. \"US\"."},"limit":{"type":"integer","minimum":1,"maximum":25,"default":10,"description":"Maximum number of matches to return (default 10)."}},"required":["name"],"additionalProperties":false}}}},"responses":{"200":{"description":"`{ query, country, count, total, results: [{ lei, legalName, registrationStatus, jurisdiction, country, city }], source, stale, cachedAt? }`.","content":{"application/json":{"schema":{"type":"object","description":"`{ query, country, count, total, results: [{ lei, legalName, registrationStatus, jurisdiction, country, city }], source, stale, cachedAt? }`."}}}},"400":{"description":"Invalid request; no payment is attempted"},"402":{"description":"Payment required; x402/MPP metadata returned in headers"},"502":{"description":"Upstream provider error after payment verification"}},"x-payment-info":{"amount":"6000","currency":"0x20c000000000000000000000b9537d11c60e8b50","description":"Find Legal Entity Identifiers by legal name, optionally filtered to an ISO 3166-1 alpha-2 country. Returns matching entities with their LEI, verified legal name, registration status, jurisdiction and city/country - the reverse of lookup, for when you have a company name but need its authoritative LEI and legal identity.","method":"tempo","preferredOffer":"mpp-tempo","price":{"mode":"fixed","currency":"USD","amount":"0.006000"},"protocols":[{"x402":{"scheme":"exact","network":"eip155:8453","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A"}},{"mpp":{"method":"evm","intent":"charge","network":"8453","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A"}},{"mpp":{"method":"tempo","intent":"charge","network":"4217","currency":"0x20c000000000000000000000b9537d11c60e8b50","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A"}}],"network":"4217","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A","offers":[{"amount":"6000","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","description":"Find Legal Entity Identifiers by legal name, optionally filtered to an ISO 3166-1 alpha-2 country. Returns matching entities with their LEI, verified legal name, registration status, jurisdiction and city/country - the reverse of lookup, for when you have a company name but need its authoritative LEI and legal identity.","intent":"charge","method":"evm","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A"},{"amount":"6000","currency":"0x20c000000000000000000000b9537d11c60e8b50","description":"Find Legal Entity Identifiers by legal name, optionally filtered to an ISO 3166-1 alpha-2 country. Returns matching entities with their LEI, verified legal name, registration status, jurisdiction and city/country - the reverse of lookup, for when you have a company name but need its authoritative LEI and legal identity.","intent":"charge","method":"tempo","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A"}]}}},"/v1/parents":{"post":{"summary":"Corporate parents by LEI","description":"Resolve a legal entity's direct and ultimate accounting-consolidating parents from GLEIF's global CC0 LEI registry. Returns parent names and LEIs, relationship status, corroboration and explicit reporting exceptions. Useful for counterparty and corporate-group diligence. Not beneficial-owner identities or ownership percentages. LEI checksum validated before payment; stale results flagged. Paid endpoint (x402 + MPP). Price: $0.006000 USDC per successful payment.","tags":["lei parent company","corporate parent","ultimate parent company","company ownership","gleif parents"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"lei":{"type":"string","minLength":20,"maxLength":20,"pattern":"^[A-Za-z0-9]{20}$"}},"required":["lei"],"additionalProperties":false},"example":{"lei":"HWUPKR0MPOU8FGXBT394"}}}},"responses":{"200":{"description":"`{ lei, found, legalName, asOf, directParent, ultimateParent, source, stale, cachedAt? }`. Each parent reports status, LEI/name/country, relationship type/status, lastUpdated, corroborationLevel and exceptionReason/exceptionReference. Nonreporting is not proof of no owner.","content":{"application/json":{"schema":{"type":"object","properties":{"lei":{"type":"string"},"found":{"type":"boolean"},"legalName":{"type":"string"},"asOf":{"type":"string"},"directParent":{"type":"object","properties":{"status":{"type":"string"},"lei":{},"legalName":{},"country":{},"relationshipType":{},"relationshipStatus":{},"lastUpdated":{},"corroborationLevel":{},"exceptionReason":{"type":"string"},"exceptionReference":{}}},"ultimateParent":{"type":"object","properties":{"status":{"type":"string"},"lei":{},"legalName":{},"country":{},"relationshipType":{},"relationshipStatus":{},"lastUpdated":{},"corroborationLevel":{},"exceptionReason":{"type":"string"},"exceptionReference":{}}},"source":{"type":"string"},"stale":{"type":"boolean"}},"description":"`{ lei, found, legalName, asOf, directParent, ultimateParent, source, stale, cachedAt? }`. Each parent reports status, LEI/name/country, relationship type/status, lastUpdated, corroborationLevel and exceptionReason/exceptionReference. Nonreporting is not proof of no owner."}}}},"400":{"description":"Invalid request; no payment is attempted"},"402":{"description":"Payment required; x402/MPP metadata returned in headers"},"502":{"description":"Upstream provider error after payment verification"}},"x-payment-info":{"amount":"6000","currency":"0x20c000000000000000000000b9537d11c60e8b50","description":"Resolve a legal entity's direct and ultimate accounting-consolidating parents from GLEIF's global CC0 LEI registry. Returns parent names and LEIs, relationship status, corroboration and explicit reporting exceptions. Useful for counterparty and corporate-group diligence. Not beneficial-owner identities or ownership percentages. LEI checksum validated before payment; stale results flagged.","method":"tempo","preferredOffer":"mpp-tempo","price":{"mode":"fixed","currency":"USD","amount":"0.006000"},"protocols":[{"x402":{"scheme":"exact","network":"eip155:8453","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A"}},{"mpp":{"method":"evm","intent":"charge","network":"8453","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A"}},{"mpp":{"method":"tempo","intent":"charge","network":"4217","currency":"0x20c000000000000000000000b9537d11c60e8b50","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A"}}],"network":"4217","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A","offers":[{"amount":"6000","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","description":"Resolve a legal entity's direct and ultimate accounting-consolidating parents from GLEIF's global CC0 LEI registry. Returns parent names and LEIs, relationship status, corroboration and explicit reporting exceptions. Useful for counterparty and corporate-group diligence. Not beneficial-owner identities or ownership percentages. LEI checksum validated before payment; stale results flagged.","intent":"charge","method":"evm","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A"},{"amount":"6000","currency":"0x20c000000000000000000000b9537d11c60e8b50","description":"Resolve a legal entity's direct and ultimate accounting-consolidating parents from GLEIF's global CC0 LEI registry. Returns parent names and LEIs, relationship status, corroboration and explicit reporting exceptions. Useful for counterparty and corporate-group diligence. Not beneficial-owner identities or ownership percentages. LEI checksum validated before payment; stale results flagged.","intent":"charge","method":"tempo","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A"}]}}}},"x-service-info":{"categories":["business"],"docs":{"homepage":"https://gleif.openverbs.com","apiReference":"https://gleif.openverbs.com/openapi.json"}}}