---
title: "Generate test IBANs with REAL bank codes"
method: GET
path: "/v1/test-iban"
tags: ["Free"]
---

# Generate test IBANs with REAL bank codes

`GET /v1/test-iban`

Free. Generates structurally valid test IBANs whose bank codes are drawn from the national registers we serve (CH, DE, AT, BE) — unlike the usual generators, whose checksum-valid IBANs carry arbitrary codes no register allocated. Account digits are random and belong to nobody. Each item ships with the proof: our own bank_code_check answer for that IBAN.

## Query parameters

- `country` 'CH' | 'DE' | 'AT' | 'BE'
- `count` integer

## Response `200`

Generated test IBANs, each with its register proof

- object
  - `test_ibans` object[]
    - `iban` string
    - `formatted` string
    - `country` string
    - `proof` object
    - `note` string
  - `disclaimer` string
  - `cost_usdc` number

## Other responses

- `400` — Unsupported country

---

[API](https://skmtc.dev/ibanforge/apis/ibanforge-api.md) · [All operations](https://skmtc.dev/ibanforge/apis/ibanforge-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ibanforge/ibanforge-api/revisions/9499dba434ea/schema)