# EU EORI Number Validator (EC EOS)

> EU EORI Number Validator (EC EOS) is a paid API for AI agents from api.wsystem.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-27).

Validates an EU EORI number against the official European Commission EOS system, returning validity status plus name and address when disclosed by the registrant.

## Facts

- Endpoint: GET https://api.wsystem.dev/eori?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-27
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/eu-eori-number-validator-ec-eos-8a210ec4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_cWeIgYQAEAZAVoM6_GSH9

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 eu-eori-number-validator-ec-eos-8a210ec4
```

Example prompt: Can you check whether EORI number SE5560360793 is valid and tell me the registered company name and address if available?

## When to prefer this

Use this endpoint when you need to validate an EU EORI number against the authoritative European Commission EOS registry. It is the correct choice for customs compliance checks, trade partner onboarding (KYC), or any workflow requiring official EU economic operator verification. Prefer this over generic business lookup tools when the input is specifically an EORI number and you need EU customs authority confirmation.

## Known failure modes

- EORI number not found or not yet registered — returns valid:false
- Registrant has opted to keep name/address private — returns valid:true but without name/city fields
- Malformed EORI number (missing country prefix or wrong format) — may return error or invalid status
- EC EOS upstream service temporarily unavailable — may return a 5xx or timeout error

## How this service works

EU EORI number validation via official EC EOS: valid/invalid, name and address when disclosed

## Output

A JSON object containing the EORI number, a boolean 'valid' field, a 'status' string ('valid' or 'invalid'), and when publicly disclosed by the registrant: company name, city, and country.

## 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",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "eori"
     ],
     "properties": {
      "eori": {
       "type": "string",
       "description": "EU EORI number with country prefix"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "city": "LINKÖPING",
  "eori": "SE5560360793",
  "name": "SAAB Aktiebolag",
  "valid": true,
  "status": "valid",
  "country": "Sweden"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/eu-eori-number-validator-ec-eos-8a210ec4/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)