# EU Agent Utils – IBAN Validation

> EU Agent Utils – IBAN Validation is a paid API for AI agents from eu-agent-utils.frcompanycheck.workers.dev, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-12).

Validates an IBAN number offline, returning check-digit correctness, SEPA eligibility, country, and parsed bank/branch/account components

## Facts

- Endpoint: GET https://eu-agent-utils.frcompanycheck.workers.dev/v1/iban/%7Biban%7D?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/eu-agent-utils-iban-validation-52f3afb5
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_IXrfZycV7Kw4PUVG1kZWa

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-agent-utils-iban-validation-52f3afb5
```

Example prompt: Can you check whether the IBAN FR7630006000011234567890189 is valid and tell me if it's SEPA-eligible and what bank and branch codes it contains?

## When to prefer this

Choose this endpoint when you need fast, offline, deterministic IBAN check-digit validation with no account or API key required, especially in European payment workflows. It is ideal for lightweight per-call usage billed in USDC fractions via x402, making it suitable for AI agents that need to validate IBANs infrequently or at variable scale without subscription overhead. Prefer it over full bank-verification services when you only need structural validity and SEPA eligibility rather than live bank reachability confirmation.

## Known failure modes

- Invalid IBAN format returns valid:false with descriptive errors array
- Unknown country prefix may return validation errors
- Malformed or empty IBAN path parameter returns an error response
- Network timeouts on the Cloudflare Workers edge (rare)
- Payment failure via x402 returns a 402 response and no charge is made

## How this service works

Cheap, deterministic utilities for AI agents, paid per call in USDC with x402 (no account, no API key): ECB euro reference FX rates and conversion, IANA time-zone conversion with explicit DST handling, European public holidays and working-day calculator (FR incl. Alsace-Moselle, BE, LU, DE, AT, IT, ES, PT), offline IBAN validation, and SIREN/SIRET and EU VAT number check-digit validation. Errors are never charged.

## Output

A JSON object containing: the normalized IBAN string, a boolean 'valid' flag, a boolean 'sepa' flag indicating SEPA zone eligibility, a 'country' field with the ISO country code, a 'parts' object with bank_code, branch_code, account_number, and national_check, and an 'errors' array listing any validation failures.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "iban": "FR7630006000011234567890189",
  "sepa": true,
  "parts": {
   "bank_code": "30006",
   "branch_code": "00001",
   "account_number": "12345678901",
   "national_check": "89"
  },
  "valid": true,
  "errors": [],
  "country": "FR"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/eu-agent-utils-iban-validation-52f3afb5/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from eu-agent-utils.frcompanycheck.workers.dev](https://www.zero.xyz/host/eu-agent-utils.frcompanycheck.workers.dev/llms.txt)