# Company KYB Check with Score

> Company KYB Check with Score is a paid API for AI agents from agentsvc.io, paid per call via x402, $0.12/call, status unknown (last checked 2026-10-16).

Performs a full EU Know Your Business (KYB) check combining LEI status, VAT/VIES validation, sanctions screening, domain/email security, and optional IBAN validation, returning a grade A–F, score 0–100, and ALLOW/CAUTION/BLOCK decision.

## Facts

- Endpoint: POST https://agentsvc.io/api/v1/proxy/kyb-check?utm_source=zero.xyz
- Price: $0.12/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/company-kyb-check-with-score-3861143d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_PiE134jWPp6FcfzaQCxE3

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 company-kyb-check-with-score-3861143d -d '<json body>'
```

Example prompt: Can you run a full KYB check on Acme GmbH — their VAT number is DE123456789 and their domain is acme.de — and tell me whether I should allow, flag, or block them before we onboard them as a supplier?

## When to prefer this

Choose this endpoint when you need a single, consolidated EU-focused business risk decision that combines VAT/VIES, LEI, sanctions, and domain checks in one call rather than calling each registry individually. It is ideal for automated onboarding flows, payment authorization gates, and supplier screening where a structured grade and ALLOW/CAUTION/BLOCK signal is needed quickly. Prefer it over building custom pipelines when speed, cost (flat $0.12 per check), and breadth of EU data sources matter more than granular raw registry data.

## Known failure modes

- Missing required inputs: if name and none of vat_number/lei/domain are provided, the call will fail or return incomplete results
- Invalid VAT format: VIES lookup fails if the VAT number has no country prefix or is malformed
- VIES service unavailable: EU VAT registry is sometimes temporarily offline, causing that section to be skipped or errored
- LEI not found: unregistered or lapsed LEI codes return no entity data
- Domain too new or unresolvable: very new domains may not have sufficient age or DMARC/SPF records
- Sanctions match is a hint, not definitive: false positives require manual review
- Network timeout: real-time lookups across multiple external registries may occasionally time out

## How this service works

Full EU company check in one call: LEI entity status, VAT validation (VIES), sanctions screening, domain age and email security, website, optional IBAN. Returns grade A to F, score 0 to 100, ALLOW, CAUTION or BLOCK, the reasons, a confidence level and the underlying sections. Pass name and at least one of vat_number, lei, domain. Use for onboarding and payment checks. Not legal advice; a sanctions match is a hint to verify by hand.

## Output

Returns a JSON object with: an overall grade (A–F), a numeric risk score (0–100), a decision flag (ALLOW, CAUTION, or BLOCK), a confidence level, the individual reasons behind the decision, and detailed sections covering LEI entity status, VIES VAT validation, sanctions screening, domain age, email security posture, and optionally IBAN validation.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "lei": {
   "type": "string"
  },
  "iban": {
   "type": "string",
   "description": "Optional IBAN to validate"
  },
  "name": {
   "type": "string",
   "description": "Company name"
  },
  "domain": {
   "type": "string"
  },
  "country": {
   "type": "string",
   "description": "ISO code, e.g. DE"
  },
  "vat_number": {
   "type": "string",
   "description": "EU VAT number with country prefix"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {},
  "success": true
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/company-kyb-check-with-score-3861143d/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agentsvc.io](https://www.zero.xyz/host/agentsvc.io/llms.txt)