---
title: "One-call KYB: VAT + registry + sanctions -> verdict"
method: POST
path: "/kyb/check"
tags: ["KYB"]
---

# One-call KYB: VAT + registry + sanctions -> verdict

`POST /kyb/check`

## Request

- Base URL: `https://api.wsystem.dev`
- URL: `https://api.wsystem.dev/kyb/check`
- Auth: none declared

Know-your-business check of an EU company in one request: VIES VAT validation, official business-register lookup and EU/UN/OFAC/UK sanctions screening, combined into a pass / review / fail verdict with reasons. x402 $0.045.

## Request body

- KybCheck
  - `company` union, required: VAT ID ('FR40303265045'), 'CC:name or registry id' ('NO:equinor'), or {name, vatNumber, country, registryId}
    - string
    - object
  - `requester` string, nullable
  - `threshold` number

## Response `200`

Successful Response

- unknown

## Other responses

- `402`: Payment Required: x402 v2 challenge (PAYMENT-REQUIRED header). Returned when the free tier is used up, or for a bare call without input.
- `422`: Validation Error
- `429`: Free tier used up and x402 disabled

---

[API](https://skmtc.dev/wsystem/apis/w-system-eu-business-data-api-vat-vies-eori-company-registry.md) · [All operations](https://skmtc.dev/wsystem/apis/w-system-eu-business-data-api-vat-vies-eori-company-registry/llms.txt) · [OpenAPI document](https://skmtc.dev/wsystem/apis/w-system-eu-business-data-api-vat-vies-eori-company-registry/revisions/ab39146b346f?raw)