{"uid":"cap_1ACRPGYO74UFD9uHXAb11","slug":"lei-validator-iso-17442-checksum-c75c14a9","name":"LEI Validator (ISO 17442 Checksum)","description":"Validate a Legal Entity Identifier (LEI, ISO 17442) with the ISO 7064 mod-97-10 check digits — not just a 20-character regex. Returns {valid, lei (normalized), louPrefix (issuing LOU), checkDigits, reason}. Confirms a counterparty/vendor LEI is well-formed before lookup; pairs with GLEIF data for name + ownership resolution. Structure + checksum only.","url":"https://2s.io/api/validate/lei","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","queryParams"],"properties":{"type":{"const":"http"},"method":{"const":"GET"},"queryParams":{"required":["lei"],"properties":{"lei":{"type":"string","description":"20-character LEI (case-insensitive)."}}}}}}},"responseSchema":{"type":"json","schema":{"type":"object","properties":{"ok":{"type":"boolean"},"items":{"type":"array","items":{"type":"object","properties":{"lei":{"type":"string"},"input":{"type":"string"},"valid":{"type":"boolean"},"reason":{},"louPrefix":{"type":"string"},"checkDigits":{"type":"string"}}}},"total":{"type":"integer"},"source":{"type":"object","properties":{"url":{"type":"string"},"license":{"type":"string"},"provider":{"type":"string"}}}}},"example":{"ok":true,"items":[{"lei":"7LTWFZYICNSX8D621K86","input":"7LTWFZYICNSX8D621K86","valid":true,"reason":null,"louPrefix":"7LTW","checkDigits":"86"}],"total":1,"source":{"url":"https://2s.io","license":"No upstream license — computed by 2s.io","provider":"2s.io LEI validator"}}},"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"lei":"2138002JK4WXAM8RNZ19"}}},"response":{"data":{"ok":true,"items":[{"lei":null,"input":"2138002JK4WXAM8RNZ19","valid":false,"reason":"checksum failed (mod-97-10 ≠ 1)","louPrefix":"2138","checkDigits":"19"}],"total":1,"source":{"url":"https://2s.io","license":"No upstream license — computed by 2s.io","provider":"2s.io LEI validator"}},"meta":{"cost":{"usd":0.001,"tier":0},"caller":"x402","version":null,"endpoint":"validate.lei","settlement":{"txHash":"0xe4921c2a30dc3fd344c122040b8753e8a3fa25ecc7a5ce1e954386e096d0e696","network":"eip155:8453","success":true}}}},"exampleRequest":{"lei":"2138002JK4WXAM8RNZ19"},"tags":["x402"],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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.0025","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0025","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_YRfSoLAL-LE_qfrVKAUTa","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.0025","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Validates a Legal Entity Identifier (LEI) string using ISO 7064 mod-97-10 check digit arithmetic, returning validity status, normalized form, issuing LOU prefix, and failure reason.","exampleAgentPrompt":"Can you check if the LEI '2138002JK4WXAM8RNZ19' is valid — I want to confirm the check digits are correct before I submit it to our trade reporting system.","exampleUseCases":null,"resultDescription":"Returns a JSON object with: 'valid' (boolean), 'lei' (normalized 20-char string), 'louPrefix' (4-char issuing LOU code), 'checkDigits' (the two check digit characters), and 'reason' (human-readable explanation if invalid). Does not perform a live GLEIF lookup — checksum and structure only.","failureModes":["LEI is not 20 characters — returns valid:false with reason explaining length error","LEI contains invalid characters (non-alphanumeric) — returns valid:false with reason","Check digit mod-97-10 calculation fails — returns valid:false with reason indicating checksum mismatch","Missing 'lei' query parameter — likely returns 400 or error JSON","Network/payment failure — HTTP 402 if x402 payment not properly handled"],"whenToPreferThis":"Use this endpoint when you need a fast, cheap structural and checksum validation of an LEI before performing a more expensive GLEIF registry lookup. Ideal for pre-filtering bad identifiers in bulk onboarding, KYC pipelines, or trade reporting flows where invalid LEIs should be rejected early. Prefer this over direct GLEIF API calls when you only need to confirm format and check digit correctness, not entity name or ownership data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T07:21:40.468Z","isFirstParty":false}