# KYB Check

> KYB Check is a paid API for AI agents from 1gateway.dev, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-29).

Vets a company by checking sanctions lists (OFAC SDN, EU, UK), GLEIF LEI registry, and EU VIES VAT validation in a single call

## Facts

- Endpoint: GET https://1gateway.dev/v1/kyb/check?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/kyb-check-2bb9b07a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ubWGDLARfycDHC_z2fLUt

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability kyb-check-2bb9b07a
```

Example prompt: 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?

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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"
           },
         
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/kyb-check-2bb9b07a/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from 1gateway.dev](https://www.zero.xyz/host/1gateway.dev/llms.txt)