{"uid":"cap_dIBhLG41Xw_Efp0b0yZ6B","slug":"forest-factory-api-lei-resolve-22be7b66","name":"Forest Factory API – LEI Resolve","description":"Machine-readable contract for active Forest paid capabilities. Unsigned paid calls return HTTP 402 with a PAYMENT-REQUIRED x402 challenge.","url":"https://http--forest-gas-station-mainnet--lcjl27p8lmjs.code.run/entity/lei-resolve?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"lei":{"type":"string","pattern":"^[A-Za-z0-9]{20}$","maxLength":20,"minLength":20,"description":"Public lei value used to scope this lookup."}}},"responseSchema":{"type":"json","example":{"ok":true,"data":{"lei":"example","found":false,"provider":"gleif","legal_name":"example","jurisdiction":"example","managing_lou":"example","entity_status":"example","legal_form_id":"example","registered_as":"example","last_update_date":"example","next_renewal_date":"example","corroboration_level":"example","registration_status":"example","headquarters_country":"example","legal_address_country":"example","initial_registration_date":"example"},"meta":{"cache":"miss","provider":"gleif-api","checked_at":"2026-01-01T00:00:00.000Z","duration_ms":0},"version":"1","capability":"entity.lei-resolve"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_73GBFmiRMoh7BjCc6H1iu","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Resolves a Legal Entity Identifier (LEI) to full GLEIF entity data including legal name, jurisdiction, status, and registration details.","exampleAgentPrompt":"Can you resolve the LEI '2594007XIACKNMUAW223' and tell me the legal name, jurisdiction, and current registration status of that entity?","exampleUseCases":[{"title":"KYC counterparty verification","prompt":"I need to verify a counterparty before onboarding them — their LEI is '9695005MSX1OYEMGDF46'. Can you pull their legal name, entity status, and what country they're headquartered in from the GLEIF registry?"},{"title":"Compliance check on expiring LEIs","prompt":"We have the LEI 'HWUPKR0MPOU8FGXBT394' for one of our clients — can you check the next renewal date and current registration status so I know if it's still valid for regulatory reporting?"},{"title":"Enriching a trade record with entity data","prompt":"I have a trade record with LEI '5493006MHB84DD0ZWV18' as the issuer — look up that LEI and give me the full legal name, legal address country, and legal form ID so I can enrich the record."}],"resultDescription":"Returns a JSON object with 'ok' status, a 'data' object containing the resolved entity fields (lei, found flag, legal_name, jurisdiction, managing_lou, entity_status, legal_form_id, registered_as, last_update_date, next_renewal_date, corroboration_level, registration_status, headquarters_country, legal_address_country, initial_registration_date), and a 'meta' object with cache status, provider name, timestamp, and response duration. Data is sourced from the GLEIF API.","failureModes":["Invalid LEI format (not exactly 20 alphanumeric characters) returns a validation error","LEI not found in GLEIF registry returns ok:true with found:false","GLEIF upstream unavailable causes delayed or error response","Missing or unsigned payment header triggers HTTP 402 PAYMENT-REQUIRED with x402 challenge","Malformed request body returns 400 error"],"whenToPreferThis":"Use this endpoint when you need to resolve a specific 20-character LEI code to its full GLEIF entity record including legal name, jurisdiction, registration status, and renewal dates. Prefer it over manual GLEIF API integration when you need metered, pay-per-call access via x402 micropayments without managing GLEIF API credentials. Ideal for compliance pipelines, KYC workflows, and trade data enrichment.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-20T06:39:28.418Z","isFirstParty":false,"canonicalSlug":"forest-factory-api-lei-resolve-22be7b66"}