{"slug":"1gateway-dev-v1-kyb-check-f1eae2","title":"Use when an agent must vet a company or counterparty before paying, onboarding o","host":"1gateway.dev","method":"GET","resource":"https://1gateway.dev/v1/kyb/check","category":"company","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 w","price_listed":0.02,"price_asked":0.02,"state":"answering","state_label":"Answering","checks_7d":1,"answered_7d":1,"latency_ms_median":341,"reported_calls_30d":3,"reported_payers_30d":1,"networks":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"],"badge":"unverified","paid_checks_7d":0,"paid_ok_7d":0,"example_input":{"method":"GET","queryParams":{"country":"DE","lei":"W38RGI023J3WT1HWRP32","name":"Siemens AG","vat":"DE129273398"},"type":"http"},"output_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"additionalProperties":false,"properties":{"method":{"enum":["GET"],"type":"string"},"queryParams":{"additionalProperties":false,"properties":{"country":{"description":"ISO 3166-1 alpha-2 country of the legal address (narrows the LEI search)","examples":["DE"],"pattern":"^[A-Za-z]{2}$","type":"string"},"lei":{"description":"Legal Entity Identifier, if known (exact LEI lookup instead of name search)","examples":["W38RGI023J3WT1HWRP32"],"pattern":"^[A-Za-z0-9]{18}[0-9]{2}$","type":"string"},"name":{"description":"Company or person name in Latin script","examples":["Siemens AG"],"maxLength":200,"type":"string"},"vat":{"description":"EU VAT number with country prefix (Greece = EL), validated in VIES","examples":["DE129273398"],"maxLength":20,"type":"string"}},"required":["name"],"type":"object"},"type":{"const":"http","type":"string"}},"required":["type","method"],"type":"object"},"output":{"properties":{"example":{"properties":{"attribution":{"properties":{"gleif":{"type":"string"},"sanctions":{"type":"string"},"vies":{"type":"string"}},"type":"object"},"disclaimer":{"type":"string"},"lei":{"properties":{"found":{"type":"boolean"},"matchedBy":{"type":"string"},"matches":{"items":{"properties":{"category":{"type":"string"},"directParent":{"type":"null"},"entityStatus":{"type":"string"},"exactName":{"type":"boolean"},"gleifUrl":{"type":"string"},"headquartersAddress":{"properties":{"city":{"type":"string"},"country":{"type":"string"},"lines":{"items":{"type":"string"},"type":"array"},"postalCode":{"type":"string"},"region":{"type":"string"}},"type":"object"},"initialRegistrationDate":{"type":"string"},"jurisdiction":{"type":"string"},"lastUpdateDate":{"type":"string"},"legalAddress":{"properties":{"city":{"type":"string"},"country":{"type":"string"},"lines":{"items":{"type":"string"},"type":"array"},"postalCode":{"type":"string"},"region":{"type":"string"}},"type":"object"},"legalForm":{"type":"string"},"legalName":{"type":"string"},"lei":{"type":"string"},"nameScore":{"type":"number"},"nextRenewalDate":{"type":"string"},"otherNames":{"items":{"type":"string"},"type":"array"},"registeredAs":{"type":"string"},"registrationStatus":{"type":"string"},"ultimateParent":{"type":"null"}},"type":"object"},"type":"array"},"note":{"type":"string"},"status":{"type":"string"}},"type":"object"},"query":{"properties":{"country":{"type":["string","null"]},"lei":{"type":["string","null"]},"name":{"type":"string"},"vat":{"type":["string","null"]}},"type":"object"},"sanctions":{"properties":{"candidates_scanned":{"type":"integer"},"lists_info":{"items":{"properties":{"aliases":{"type":"integer"},"as_of":{"type":"string"},"checked_at":{"type":"string"},"data_age_days":{"type":"integer"},"digital_currency_addresses":{"type":"integer"},"entries":{"type":"integer"},"lists":{"properties":{"eu":{"properties":{"entries":{"type":"integer"},"generated":{"type":"string"}},"type":"object"},"uk":{"properties":{"entries":{"type":"integer"},"generated":{"type":"string"}},"type":"object"}},"type":"object"},"published":{"type":"string"},"source":{"type":"string"},"source_url":{"type":"string"},"stale":{"type":"boolean"},"version":{"type":"string"},"warning":{"type":"string"}},"type":"object"},"type":"array"},"matches":{"items":{"properties":{"entry":{"properties":{"aliases":{"items":{"type":"string"},"type":"array"},"countries":{"items":{"type":"string"},"type":"array"},"digitalCurrencyAddresses":{"items":{},"type":"array"},"lists":{"items":{"properties":{"entryId":{"type":"string"},"list":{"type":"string"},"listedDate":{"type":["string","null"]},"programmes":{"items":{"type":"string"},"type":"array"}},"type":"object"},"type":"array"},"name":{"type":"string"},"ofacUrl":{"type":"string"},"programs":{"items":{"type":"string"},"type":"array"},"type":{"type":"string"},"uid":{"type":"integer"}},"type":"object"},"exact":{"type":"boolean"},"matchedOn":{"type":"string"},"score":{"type":"number"}},"type":"object"},"type":"array"}},"type":"object"},"summary":{"properties":{"lei":{"type":["string","null"]},"leiEntityStatus":{"type":["string","null"]},"leiFound":{"type":"boolean"},"sanctionsHits":{"type":"integer"},"sanctionsLists":{"items":{"type":"string"},"type":"array"},"sanctionsTopScore":{"type":["integer","null"]},"unavailable":{"items":{},"type":"array"},"vatValid":{"type":["boolean","null"]}},"type":"object"},"vat":{"properties":{"address":{"type":"null"},"name":{"type":"null"},"requestDate":{"type":"string"},"status":{"type":"string"},"valid":{"type":"boolean"},"vat":{"type":"string"}},"type":"object"}},"required":["query","summary","sanctions","lei","vat","attribution","disclaimer"],"type":"object"},"type":{"type":"string"}},"required":["type"],"type":"object"}},"required":["input"],"type":"object"},"history":[{"day":"2026-10-24","reachable":true,"status":402,"valid_402":true,"asked_usdc":0.02,"price_match":true,"latency_ms":341,"error":null}],"description_full":"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","last_updated":"2026-10-23T17:02:08.373Z","schemes":["exact"]}