# EU EORI Number Validator

> EU EORI Number Validator is a paid API for AI agents from data.greeneris.io, paid per call via x402, $0.003/call, status unknown (last checked 2026-09-13).

Validates an EORI number against the European Commission's official EOS/DDS2 registry and returns the operator's registration status, name, and address

## Facts

- Endpoint: GET https://data.greeneris.io/v1/eu/eori
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/eu-eori-number-validator-65bf5544
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_gptH12QzB_20SY9sCHCd3

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-65bf5544
```

Example prompt: Can you check if EORI number FR38347481400100 is valid and tell me the company name and address registered to it?

## When to prefer this

Use this endpoint when you need to verify that a business is officially registered as an EU customs operator before executing cross-border trade, onboarding a supplier, or processing an import/export transaction. It is the authoritative source via the European Commission's own registry, not a third-party database, making it suitable for compliance workflows. Prefer this over general business registry lookups when the specific need is customs clearance eligibility across EU member states.

## Known failure modes

- Invalid EORI format (not 2-letter country code + 1-15 alphanumerics) returns a validation error
- EORI exists but operator opted out of publication — valid=true but no name/address returned
- Unknown or unregistered EORI returns valid=false
- Upstream European Commission SOAP service temporarily unavailable — possible 5xx or stale cache response
- Payment failure (x402) if USDC balance insufficient

## How this service works

Live EORI (Economic Operators Registration and Identification) validation via the European Commission EOS/DDS2 service -- the number every business needs to clear customs in the EU. Query: ?eori=FR38347481400100 (2-letter country + up to 15 alphanumerics). Returns valid true/false plus registered name and address when the operator consented to publication. SOAP upstream, clean JSON out; 24h cache.

## Output

A JSON object containing a boolean 'valid' field indicating whether the EORI is registered, and when the operator has consented to publication, the registered business name and address. Results are cached for 24 hours from the live European Commission EOS/DDS2 SOAP service.

## 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": "EORI number: 2-letter country code + 1-15 alphanumerics (FR uses SIRET)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "eori": "FR38347481400100",
  "name": "AIRBUS",
  "valid": true,
  "source": "European Commission EOS/DDS2",
  "address": "2 Rond-point EMILE DEWOITINE, 31700, BLAGNAC, France",
  "status_description": "Valid"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/eu-eori-number-validator-65bf5544/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from data.greeneris.io](https://www.zero.xyz/host/data.greeneris.io/llms.txt)