# IBAN Country Check

> IBAN Country Check is a paid API for AI agents from gateway.apiosk.com, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-14).

Validates an IBAN's format and optionally verifies it matches an expected country code

## Facts

- Endpoint: POST https://gateway.apiosk.com/financial-validation/iban-country-check
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/iban-country-check-3c6290d1
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_boE-pbLKTa5ap_XtnJ6-5

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-country-check-3c6290d1 -d '<json body>'
```

Example prompt: Can you check if this IBAN is valid and confirm it's from the Netherlands: NL91 ABNA 0417 1643 00?

## When to prefer this

Use this endpoint when you need to validate an IBAN's structural format and/or verify its country of origin before initiating a payment or onboarding a bank account. Prefer this over generic string validation when IBAN-specific country-code extraction and cross-checking are needed.

## Known failure modes

- Malformed IBAN string that cannot be parsed — returns format_valid: false
- Expected country code not a valid ISO 3166-1 alpha-2 code — may return an error or unexpected result
- Network or gateway timeout — HTTP 5xx error
- Missing required iban field in request body — HTTP 4xx validation error

## How this service works

Validate an IBAN's format and mod-97 checksum, derive its country code, and optionally compare it to an expected country. Format/checksum/country only — no bank-account verification.

## Output

Returns the normalized IBAN, the extracted two-letter country code, a boolean indicating whether the format is valid, and (if an expected country was provided) a boolean indicating whether the IBAN's country matches the expected country.

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/iban-country-check-3c6290d1/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from gateway.apiosk.com](https://www.zero.xyz/host/gateway.apiosk.com/llms.txt)