# IBAN Validator

> IBAN Validator is a paid API for AI agents from bank-validators.x402tookit.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-11-02).

Validates an IBAN using ISO 13616 mod-97 checksum plus per-country length and layout rules across 88 registry countries.

## Facts

- Endpoint: GET https://bank-validators.x402tookit.com/iban-validate?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/iban-validator-9a301e34
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_BllEq0aDrSBAmlXXBb0eU

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 iban-validator-9a301e34
```

Example prompt: Can you check whether GB82 WEST 1234 5698 7654 32 is a valid IBAN — I want to know if the checksum passes and whether the length is correct for a UK account before I send a payment?

## When to prefer this

Choose this endpoint when you need rigorous ISO 13616-compliant IBAN validation including mod-97 checksum and per-country length/layout rules across 88 countries. Prefer it over basic regex checks when correctness matters for payment processing, financial onboarding, or compliance workflows. Use the sibling IBAN parser endpoint if you additionally need the account broken into its component fields (bank code, branch, account number).

## Known failure modes

- Invalid IBAN checksum returns verdict=invalid with reasons listing the mod-97 failure
- Wrong length for the country returns actualLength vs expectedLength mismatch in the response
- Unsupported or unrecognized country code returns an error or degraded=true
- Malformed input (non-alphanumeric characters beyond spaces) may return a parsing error
- Network or service outage returns HTTP error code

## How this service works

Validate an IBAN: ISO 13616 mod-97 checksum plus per-country length and layout for 88 registry countries.

## Output

Returns a verdict (valid/invalid), normalized and grouped IBAN string, detected country, actual vs expected length, list of failure reasons if invalid, number of supported countries, source and timestamp metadata, and a disclaimer about format-only validation.

## 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"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "iban"
     ],
     "properties": {
      "iban": {
       "type": "string",
       "description": "IBAN, spaces allowed, e.g. GB82 WEST 1234 5698 7654 32"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "asOf": {
       "type": [
        "null",
        "string"
       ]
      },
      "source": {
       "type": [
        "null",
        "string"
       ]
      },
      "country": {
       "type": [
        "null",
        "string"
       ]
      },
      "grouped": {
       "type": [
        "null",
        "string"
       ]
      },
      "reasons": {
       "type": [
        "array",
        "null"
       ],
       "items": {
        "type": "string"
       }
      },
      "summary": {
       "type": [
        "null",
        "string"
       ]
      },
      "verdict": {
       "type": [
        "null",
        "string"
       ]
      },
      "degraded": {
       "type": [
        "boolean",
        "null"
       ]
      },
      "disclaimer": {
       "type": [
        "null",
        "string"
       ]
      },
      "normalized": {
       "type": [
        "null",
        "string"
       ]
      },
      "notChecked": {
       "type": [
        "array",
        "null"
       ],
       "items": {
        "type": "string"
       }
      },
      "actualLength": {
       "type": [
        "null",
        "number"
       ]
      },
      "expectedLength": {
       "type": [
        "null",
        "number"
       ]
      },
      "countriesSupported": {
       "type": [
        "null",
        "number"
       ]
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/iban-validator-9a301e34/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from bank-validators.x402tookit.com](https://www.zero.xyz/host/bank-validators.x402tookit.com/llms.txt)