{"uid":"cap_oL0KDLDsRQAvYelirBkIF","slug":"2s-business-entity-match-749485b1","name":"2s Business Entity Match","description":"Fuzzy entity resolution: resolve a messy, free-text company name to its canonical GLEIF Legal Entity Identifier (LEI) with a 0-1 similarity score and a high/medium/low confidence label. Tolerant of legal-suffix noise (Inc/Ltd/GmbH/S.A.), word order, ampersands, punctuation, and former/alternate names (e.g. 'Apple Computer Inc' resolves to Apple Inc. via GLEIF's recorded other-names). Returns the top candidates ranked by score plus a single bestMatch (null when nothing clears medium confidence — so a low-confidence top hit is never silently treated as a match, which is the safe default for KYB). The record-linkage complement to business.lei (name search). Optional country (ISO-2) narrows to a jurisdiction. Backed by GLEIF Golden Copy (~2.6M entities, CC0).","url":"https://2s.io/api/business/entity-match?utm_source=zero.xyz","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":{"type":"object","required":["name"],"properties":{"name":{"type":"string","maxLength":200,"minLength":2,"description":"Free-text company / legal-entity name to resolve. Messy input is fine: \"Apple Computer Inc.\", \"jp morgan chase & co\"."},"limit":{"type":"integer","default":5,"maximum":25,"minimum":1,"description":"Max ranked candidates to return (1-25). Default 5."},"country":{"type":"string","maxLength":2,"minLength":2,"description":"Optional ISO-2 country of the entity HQ to narrow the match (e.g., \"US\", \"DE\", \"GB\")."}},"additionalProperties":false}}}}},"responseSchema":null,"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"name":"Apple Inc","limit":5,"country":"US"}}},"response":{"data":{"ok":true,"meta":{"query":{"name":"Apple Inc","limit":5,"country":"US"},"bestMatch":{"lei":"HWUPKR0MPOU8FGXBT394","score":1,"legalName":"Apple Inc.","confidence":"high"}},"items":[{"lei":"HWUPKR0MPOU8FGXBT394","score":1,"legalName":"Apple Inc.","otherName":"Apple Computer, Inc.","confidence":"high","entityStatus":"ACTIVE","headquarters":{"city":"Cupertino","region":"US-CA","country":"US"},"jurisdiction":"US-CA","registrationStatus":"ISSUED"},{"lei":"2549002NLVM9K2FAVE26","score":0.587,"legalName":"APPLE CAL LLC","otherName":null,"confidence":"low","entityStatus":"ACTIVE","headquarters":{"city":"Dallas","region":"US-TX","country":"US"},"jurisdiction":"US-NV","registrationStatus":"LAPSED"},{"lei":"549300SYJRNYQCHQ5590","score":0.587,"legalName":"APPLE BUS COMPANY","otherName":null,"confidence":"low","entityStatus":"ACTIVE","headquarters":{"city":"Cleveland","region":"US-MO","country":"US"},"jurisdiction":"US-MO","registrationStatus":"LAPSED"},{"lei":"254900KZR24L5GN8TE52","score":0.572,"legalName":"Apple Ford, Inc.","otherName":null,"confidence":"low","entityStatus":"ACTIVE","headquarters":{"city":"Columbia","region":"US-MD","country":"US"},"jurisdiction":"US-DE","registrationStatus":"LAPSED"},{"lei":"254900U3BNVDWHW73852","score":0.572,"legalName":"APPLE TREE HOLDINGS LLC","otherName":null,"confidence":"low","entityStatus":"ACTIVE","headquarters":{"city":"SALEM","region":"US-OR","country":"US"},"jurisdiction":"US-OR","registrationStatus":"LAPSED"}],"total":382,"source":{"url":"https://www.gleif.org/en/lei-data/gleif-golden-copy","license":"CC0 1.0 (public domain). No attribution required.","provider":"GLEIF (Global Legal Entity Identifier Foundation) — LEI Golden Copy"}},"meta":{"cost":{"usd":0.00288,"tier":0},"caller":"x402","version":null,"endpoint":"business.entity-match","settlement":{"txHash":"0x227d9c69b7d9594e81024e07e57abd95432935f051d839f62c6110f87b4e1e51","network":"eip155:8453","success":true}}}},"exampleRequest":{"name":"Apple Inc","limit":5,"country":"US"},"tags":["x402"],"displayCostAmount":"0.00288","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.00288/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0072","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0072","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_KqbsXe7K0B0-SqT0ZU0Kn","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.0072","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Resolves a free-text company or legal entity name to ranked LEI candidates with confidence scores and headquarters data","exampleAgentPrompt":"Can you find the official LEI code and headquarters for 'JP Morgan Chase & Co' — search as a US entity and return the top 3 matches with confidence scores?","exampleUseCases":null,"resultDescription":"Returns a ranked list of up to 25 legal entity candidates, each with their LEI code, legal name, alternate name, fuzzy match score, confidence level (high/medium/low), jurisdiction, entity status, registration status, and headquarters city/region/country. Also includes a bestMatch summary in metadata and source/license attribution.","failureModes":["No matching entities found for very obscure or misspelled names — returns empty items array","Ambiguous name with many partial matches — low confidence scores across all candidates","Country filter too restrictive — entity exists but not in specified country, returns empty","Name string too short (under 2 chars) or too long (over 200 chars) — validation error","Payment failure via x402 — 402 response if USDC payment not provided","Upstream GLEIF data unavailability — service may return error or stale data"],"whenToPreferThis":"Use this endpoint when you need to resolve a free-text company name to a verified LEI code for KYC, financial compliance, or entity enrichment workflows — especially when input is messy or informal. Prefer over manual GLEIF search when automating entity resolution at scale without requiring API keys or subscriptions.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T00:46:58.381Z","isFirstParty":false,"canonicalSlug":"2s-business-entity-match-749485b1"}