---
title: "List all supported IBAN countries (free)"
method: GET
path: "/v1/iban/structure"
tags: ["Free"]
---

# List all supported IBAN countries (free)

`GET /v1/iban/structure`

FREE metadata endpoint: lists every supported IBAN country with its IBAN length, SEPA membership, and whether a BBAN structure breakdown and example IBAN are available. Use GET /v1/iban/structure/{country} for the full per-country template.

## Response `200`

List of supported countries

- object
  - `total` integer, required — Number of supported IBAN countries
  - `countries` object[], required
    - `code` string
    - `name` string
    - `iban_length` integer
    - `sepa_member` boolean
    - `has_bban_structure` boolean
    - `has_example` boolean
  - `endpoint_per_country` string
  - `cost_usdc` number

## Other responses

- `429` — Rate limit exceeded. Honour the Retry-After header; see https://api.ibanforge.com/rate-limits.yml

---

[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)