# Supplier Identity and VAT Verification

> Supplier Identity and VAT Verification is a paid API for AI agents from supplier-payment-verifier-production.up.railway.app, paid per call via x402, $0.05/call, status unknown (last checked 2026-10-15).

Verifies a supplier's legal name, company registration number, and VAT number against the Irish CRO and EU VIES, returning an advisory RELEASE, REVIEW, BLOCK, or INSUFFICIENT_EVIDENCE decision before paying an invoice.

## Facts

- Endpoint: POST https://supplier-payment-verifier-production.up.railway.app/v1/verifications?utm_source=zero.xyz
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/supplier-identity-and-vat-verification-8a40c6db
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_6VEeH3sGVmUrMgEbRa6T_

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 supplier-identity-and-vat-verification-8a40c6db -d '<json body>'
```

Example prompt: Before we pay this invoice from Acme Supplies Ltd, can you verify them — their claimed legal name is 'Acme Supplies Ltd', their Irish CRO number is 123456, their VAT number is IE1234567T, and their country code is IE?

## When to prefer this

Choose this endpoint when processing B2B supplier invoices from Irish or EU-registered companies and you need a structured, policy-backed advisory decision (RELEASE/REVIEW/BLOCK) rather than a raw data lookup. It is specifically suited to accounts-payable automation workflows where you want a single call that cross-checks legal name, CRO registration, and EU VAT status in one step, with reason codes for audit trails. Prefer this over manual CRO/VIES queries when you need a decision recommendation, not just raw registry data.

## Known failure modes

- Invalid or missing country_code returns a validation error
- VAT number format mismatch (e.g. missing country prefix) causes VIES lookup failure
- CRO number not found in the Irish registry returns INSUFFICIENT_EVIDENCE
- VIES service temporarily unavailable may degrade VAT check result
- Mismatched legal name results in a REVIEW or BLOCK decision
- Missing required fields (claimed_legal_name or country_code) returns a 400-level error

## How this service works

Use before paying a supplier invoice to check that the supplier is who it claims to be. Reconciles the claimed legal name, company registration number and VAT number against the Irish Companies Registration Office (IE) and the EU VIES VAT service, and returns an advisory RELEASE, REVIEW, BLOCK or INSUFFICIENT_EVIDENCE decision with per-check results and reason codes. Advisory only: it never executes or authorises a payment.

## Output

Returns an advisory decision (RELEASE, REVIEW, BLOCK, or INSUFFICIENT_EVIDENCE) along with individual check results for legal name, company registration, and VAT number, plus structured reason codes explaining each sub-decision. Does not execute or authorise any payment.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "supplier": {
   "type": "object",
   "required": [
    "claimed_legal_name",
    "country_code"
   ],
   "properties": {
    "vat_number": {
     "type": "string",
     "description": "VAT number including country prefix."
    },
    "country_code": {
     "type": "string",
     "description": "ISO 3166-1 alpha-2 code, e.g. IE."
    },
    "claimed_legal_name": {
     "type": "string",
     "description": "Legal name on the invoice."
    },
    "company_registration_number": {
     "type": "string",
     "description": "Registry company number, e.g. the CRO number for IE."
    }
   },
   "description": "The supplier claim to verify."
  },
  "policy_id": {
   "const": "eu-b2b-payment-v1",
   "description": "Always eu-b2b-payment-v1."
  },
  "request_id": {
   "type": "string",
   "format": "uuid",
   "description": "Caller-generated unique id."
  },
  "schema_version": {
   "const": "1.0",
   "description": "Always 1.0."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "checks": [
   {
    "code": "ENTITY_MATCH",
    "outcome": "PASS",
    "summary": "Company registry record matched."
   },
   {
    "code": "VAT_VALID",
    "outcome": "PASS",
    "summary": "VAT registration is valid."
   }
  ],
  "policy": {
   "id": "eu-b2b-payment-v1",
   "version": "1.0.0"
  },
  "status": "COMPLETED",
  "billing": {
   "meter": "verification.completed",
   "units": 1,
   "billable": true
  },
  "decision": "RELEASE",
  "created_at": "2026-10-13T12:48:01Z",
  "request_id": "76de334e-f97f-4fef-accc-75b1ed0a634e",
  "completed_at": "2026-10-13T12:48:02Z",
  "reason_codes": [
   "ALL_REQUIRED_CHECKS_PASSED"
  ],
  "advisory_only": true,
  "schema_version": "1.0",
  "verification_id": "a75d7f47-5af4-4e61-a697-0df83f548878"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/supplier-identity-and-vat-verification-8a40c6db/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from supplier-payment-verifier-production.up.railway.app](https://www.zero.xyz/host/supplier-payment-verifier-production.up.railway.app/llms.txt)