# Netzhandwerker IBAN Check

> Netzhandwerker IBAN Check is a paid API for AI agents from tools.netzhandwerker.de, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-14).

Validates an IBAN (and optionally a BIC) for format correctness, checksum validity, SEPA eligibility, and BIC-IBAN consistency.

## Facts

- Endpoint: POST https://tools.netzhandwerker.de/v1/iban/check
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/netzhandwerker-iban-check-a4f1c785
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_OHwbaFNz5rciPWVx-X1s_

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 netzhandwerker-iban-check-a4f1c785 -d '<json body>'
```

Example prompt: Can you check if the IBAN DE89 3704 0044 0532 0130 00 is valid, and verify it against the BIC COBADEFFXXX?

## When to prefer this

Use this endpoint when you need a fast, cheap, formal IBAN validation with BIC matching and SEPA eligibility checks — particularly useful in payment automation, onboarding flows, or supplier management pipelines where you want to catch formatting and checksum errors before initiating a real transfer. Note that it performs formal/structural validation only and does not verify whether the account actually exists at the bank.

## Known failure modes

- Malformed IBAN input that cannot be parsed returns valid=false with issues array populated
- IBAN from a country not in the SEPA register returns country_in_register=false
- BIC provided does not match the IBAN's bank code, returning bic_matches_iban=false
- IBAN with incorrect checksum returns checksum_valid=false
- Payment fails if USDC balance is insufficient for the $0.001 x402 fee
- Network timeout or service unavailability returns an HTTP error

## How this service works

x402-Werkzeuge für autonome Agenten.

## Output

A JSON object containing: whether the IBAN is valid, the checksum validity flag, SEPA eligibility, the formatted IBAN, the raw BBAN, parsed BBAN components (bank code, account number), country code, expected and actual length, a list of any issues found, a note clarifying that existence of the account is not verified, and BIC details (if present or derivable) including branch, country, location, primary-office status, format validity, and whether the BIC matches the IBAN.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "bic": {
   "type": "string",
   "description": "BIC zum Abgleich, optional"
  },
  "iban": {
   "type": "string",
   "description": "IBAN mit oder ohne Leerzeichen"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "bic": {
   "value": "COBADEFFXXX",
   "branch": "XXX",
   "country": "DE",
   "location": "FF",
   "bank_code": "COBA",
   "format_valid": true,
   "is_primary_office": true
  },
  "bban": "370400440532013000",
  "iban": "DE89370400440532013000",
  "note": "Formale Pruefung. Es wird nicht geprueft, ob das Konto existiert.",
  "sepa": true,
  "input": "DE89 3704 0044 0532 0130 00",
  "valid": true,
  "issues": [],
  "length": 22,
  "country": "DE",
  "formatted": "DE89 3704 0044 0532 0130 00",
  "bban_parts": {
   "Kontonummer": "0532013000",
   "Bankleitzahl": "37040044"
  },
  "check_digits": "89",
  "checksum_valid": true,
  "expected_length": 22,
  "bic_matches_iban": true,
  "country_in_register": true
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/netzhandwerker-iban-check-a4f1c785/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from tools.netzhandwerker.de](https://www.zero.xyz/host/tools.netzhandwerker.de/llms.txt)