{"uid":"cap_ubWGDLARfycDHC_z2fLUt","slug":"kyb-check-2bb9b07a","name":"KYB Check","description":"Use when an agent must vet a company or counterparty before paying, onboarding or invoicing. Input: name, optional country (ISO2), lei, vat (EU, with prefix). Output: JSON summary (sanctions hits, LEI found/status, VAT valid), sanctions matches across OFAC SDN, EU and UK lists, GLEIF entity record with parents, VIES VAT result; a down VIES/GLEIF marks only that part. Not a legal determination. Example: ?name=Siemens+AG&lei=W38RGI023J3WT1HWRP32&vat=DE129273398","url":"https://1gateway.dev/v1/kyb/check?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"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["name"],"properties":{"lei":{"type":"string","pattern":"^[A-Za-z0-9]{18}[0-9]{2}$","examples":["W38RGI023J3WT1HWRP32"],"description":"Legal Entity Identifier, if known (exact LEI lookup instead of name search)"},"vat":{"type":"string","examples":["DE129273398"],"maxLength":20,"description":"EU VAT number with country prefix (Greece = EL), validated in VIES"},"name":{"type":"string","examples":["Siemens AG"],"maxLength":200,"description":"Company or person name in Latin script"},"country":{"type":"string","pattern":"^[A-Za-z]{2}$","examples":["DE"],"description":"ISO 3166-1 alpha-2 country of the legal address (narrows the LEI search)"}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["query","summary","sanctions","lei","vat","attribution","disclaimer"],"properties":{"lei":{"type":"object","properties":{"note":{"type":"string"},"found":{"type":"boolean"},"status":{"type":"string"},"matches":{"type":"array","items":{"type":"object","properties":{"lei":{"type":"string"},"category":{"type":"string"},"gleifUrl":{"type":"string"},"exactName":{"type":"boolean"},"legalForm":{"type":"string"},"legalName":{"type":"string"},"nameScore":{"type":"number"},"otherNames":{"type":"array","items":{"type":"string"}},"directParent":{"type":"null"},"entityStatus":{"type":"string"},"jurisdiction":{"type":"string"},"legalAddress":{"type":"object","properties":{"city":{"type":"string"},"lines":{"type":"array","items":{"type":"string"}},"region":{"type":"string"},"country":{"type":"string"},"postalCode":{"type":"string"}}},"registeredAs":{"type":"string"},"lastUpdateDate":{"type":"string"},"ultimateParent":{"type":"null"},"nextRenewalDate":{"type":"string"},"registrationStatus":{"type":"string"},"headquartersAddress":{"type":"object","properties":{"city":{"type":"string"},"lines":{"type":"array","items":{"type":"string"}},"region":{"type":"string"},"country":{"type":"string"},"postalCode":{"type":"string"}}},"initialRegistrationDate":{"type":"string"}}}},"matchedBy":{"type":"string"}}},"vat":{"type":"object","properties":{"vat":{"type":"string"},"name":{"type":"null"},"valid":{"type":"boolean"},"status":{"type":"string"},"address":{"type":"null"},"requestDate":{"type":"string"}}},"query":{"type":"object","properties":{"lei":{"type":["string","null"]},"vat":{"type":["string","null"]},"name":{"type":"string"},"country":{"type":["string","null"]}}},"summary":{"type":"object","properties":{"lei":{"type":["string","null"]},"leiFound":{"type":"boolean"},"vatValid":{"type":["boolean","null"]},"unavailable":{"type":"array","items":{}},"sanctionsHits":{"type":"integer"},"sanctionsLists":{"type":"array","items":{"type":"string"}},"leiEntityStatus":{"type":["string","null"]},"sanctionsTopScore":{"type":["integer","null"]}}},"sanctions":{"type":"object","properties":{"matches":{"type":"array","items":{"type":"object","properties":{"entry":{"type":"object","properties":{"uid":{"type":"integer"},"name":{"type":"string"},"type":{"type":"string"},"lists":{"type":"array","items":{"type":"object","properties":{"list":{"type":"string"},"entryId":{"type":"string"},"listedDate":{"type":["string","null"]},"programmes":{"type":"array","items":{"type":"string"}}}}},"aliases":{"type":"array","items":{"type":"string"}},"ofacUrl":{"type":"string"},"programs":{"type":"array","items":{"type":"string"}},"countries":{"type":"array","items":{"type":"string"}},"digitalCurrencyAddresses":{"type":"array","items":{}}}},"exact":{"type":"boolean"},"score":{"type":"number"},"matchedOn":{"type":"string"}}}},"lists_info":{"type":"array","items":{"type":"object","properties":{"as_of":{"type":"string"},"lists":{"type":"object","properties":{"eu":{"type":"object","properties":{"entries":{"type":"integer"},"generated":{"type":"string"}}},"uk":{"type":"object","properties":{"entries":{"type":"integer"},"generated":{"type":"string"}}}}},"stale":{"type":"boolean"},"source":{"type":"string"},"aliases":{"type":"integer"},"entries":{"type":"integer"},"version":{"type":"string"},"warning":{"type":"string"},"published":{"type":"string"},"checked_at":{"type":"string"},"source_url":{"type":"string"},"data_age_days":{"type":"integer"},"digital_currency_addresses":{"type":"integer"}}}},"candidates_scanned":{"type":"integer"}}},"disclaimer":{"type":"string"},"attribution":{"type":"object","properties":{"vies":{"type":"string"},"gleif":{"type":"string"},"sanctions":{"type":"string"}}}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_3WuGbYZuaVcM-FtKqkTuS","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Vets a company by checking sanctions lists (OFAC SDN, EU, UK), GLEIF LEI registry, and EU VIES VAT validation in a single call","exampleAgentPrompt":"Before I wire payment to Siemens AG (LEI: W38RGI023J3WT1HWRP32, VAT: DE129273398), can you run a KYB check to confirm they're not on any OFAC, EU, or UK sanctions lists and that their LEI and VAT are valid?","exampleUseCases":[{"title":"Screen vendor before onboarding","prompt":"We're about to onboard a new supplier called Alibaba Group Holding, based in CN — can you run a KYB check to see if they appear on any sanctions lists and pull their GLEIF entity record?"},{"title":"Validate EU VAT before invoicing","prompt":"Before I send an invoice to this German company, can you verify that their VAT number DE129273398 is valid in VIES and check that they're not sanctioned?"},{"title":"Vet counterparty before cross-border payment","prompt":"I need to pay a company called Rusal — can you check if they're on the OFAC SDN list, EU sanctions list, or UK sanctions list before I approve the wire?"}],"resultDescription":"Returns a JSON object with a summary section (sanctions hits boolean, LEI found/status, VAT valid), detailed sanctions matches from OFAC SDN, EU, and UK lists, a GLEIF entity record including legal name, jurisdiction, legal address, entity status, legal form, parent entities, and a VIES VAT validation result. Partial results are returned if VIES or GLEIF is temporarily unavailable, with a note indicating which component was down. Includes attribution and a disclaimer that this is not a legal determination.","failureModes":["VIES service down — sanctions and LEI checks still returned, VAT result marked unavailable","GLEIF service down — sanctions checks still returned, LEI result marked unavailable","Name not found in any registry — returns empty matches arrays with found: false","Invalid LEI format — request rejected with schema validation error","Missing required 'name' parameter — returns 400 error","EU VAT number without country prefix causes validation failure","Rate limiting or payment failure via x402 protocol returns 402"],"whenToPreferThis":"Use this endpoint when an agent needs a single aggregated KYB check covering sanctions (OFAC, EU, UK), LEI registry, and EU VAT validation in one call rather than querying each source separately. It is especially appropriate before approving payments, onboarding new vendors, or invoicing counterparties where regulatory compliance is required. Prefer it over standalone OFAC-only or GLEIF-only lookups when you need a holistic compliance snapshot of a legal entity.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T00:33:03.824Z","isFirstParty":false,"canonicalSlug":"kyb-check-2bb9b07a"}