# W System KYB Check – EU VAT, EORI & Company Validation

> W System KYB Check – EU VAT, EORI & Company Validation is a paid API for AI agents from api.wsystem.dev, paid per call via x402, $0.045/call, status unknown (last checked 2026-10-27).

Runs a comprehensive Know Your Business (KYB) check on a company by validating its EU VAT number (via VIES), EORI number, company registry details, and sanctions exposure, returning a pass/fail verdict with reasons.

## Facts

- Endpoint: POST https://api.wsystem.dev/kyb/check?utm_source=zero.xyz
- Price: $0.045/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-27
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/w-system-kyb-check-eu-vat-eori-company-validation-bccfd337
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_7WVr92PIzS_OLaBfR8E8Y

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 w-system-kyb-check-eu-vat-eori-company-validation-bccfd337 -d '<json body>'
```

Example prompt: Can you run a full KYB check on this company — their VAT number is DE123456789 — and tell me if they pass or fail, and why?

## When to prefer this

Choose this endpoint when you need a combined, single-call KYB verdict that checks EU VAT validity (VIES), EORI status, company registry presence, and sanctions exposure together. It is ideal for automated vendor onboarding, B2B invoice validation, or compliance workflows where you need a structured pass/fail verdict rather than raw registry data. Prefer it over individual VAT or EORI endpoints when you want a holistic risk assessment in one call.

## Known failure modes

- Invalid or malformed VAT number format returns a fail verdict with a formatting reason
- VIES service temporarily unavailable causes a service error
- Unknown country code in company object results in validation error
- Company not found in EU registry returns fail verdict
- Threshold parameter out of range may cause unexpected scoring behavior

## How this service works

One-call KYB check of an EU company: VIES VAT validation + official business register + EU/UN/OFAC/UK sanctions screening -> pass/review/fail verdict ($0.045 per company)

## Output

Returns a JSON object with a 'verdict' field ('pass' or 'fail') and a 'reasons' array listing any issues found, such as invalid VAT registration, EORI mismatch, or sanctions hits. An empty reasons array with verdict 'pass' indicates the company cleared all checks.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "company": {
   "description": "VAT ID, 'CC:name', or {name, vatNumber, country, registryId}"
  },
  "threshold": {
   "type": "number"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "reasons": [],
  "verdict": "pass"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/w-system-kyb-check-eu-vat-eori-company-validation-bccfd337/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.wsystem.dev](https://www.zero.xyz/host/api.wsystem.dev/llms.txt)