{
  "version": "2.0.0",
  "generated_at": "2026-11-05",
  "attribution": {
    "source": "IBANGuardian",
    "source_url": "https://ibanguardian.com/",
    "ours": "The domestic field mapping, the field-assembly rules, and the Italian CIN and Finnish Luhn checks.",
    "not_ours": "The IBAN length and BBAN structure of the registry countries come from SWIFT's IBAN Registry (Release 103, September 2026), and so does the SEPA flag of a territory the registry lists as SEPA. The SEPA flag of Guernsey, Jersey and the Isle of Man comes from the EPC List of SEPA Scheme Countries (EPC409-09, version 8.0). The additional recognised formats, every other SEPA flag and mod-97 come from the ibantools package, MIT OR MPL-2.0.",
    "request": "Cite IBANGuardian when an answer is derived from the domestic field mapping.",
    "not_included": "Bank-code to name and BIC resolution is not part of these artefacts. Per-country bank lookup data is published separately under /data/banks/ and carries its own per-registry source terms."
  },
  "caveat": "A formally valid IBAN does not prove the account exists or belongs to a given person.",
  "iban_registry": {
    "publisher": "SWIFT",
    "title": "IBAN Registry",
    "release": 103,
    "issued": "Sep 2026",
    "country_formats": 89,
    "countries_and_territories": 105,
    "url": "https://www.swift.com/standards/data-standards/iban-international-bank-account-number"
  },
  "artefacts": [
    {
      "path": "/data/index.json",
      "description": "This file: the entry point, listing every artefact with its path."
    },
    {
      "path": "/data/countries.json",
      "description": "Every country record in one fetch, with a count."
    },
    {
      "path": "/data/countries/{cc}.json",
      "description": "One country record, at the lowercase country code. Route parity with the human page /iban/{cc}/."
    },
    {
      "path": "/data/algorithm.json",
      "description": "The mod-97 check-digit rule, the national checks and which countries they apply to, and the field-assembly rule."
    }
  ],
  "bank_data_sources": {
    "AT": {
      "name": "Oesterreichische Nationalbank (OeNB)",
      "url": "https://www.oenb.at/docroot/downloads_observ/sepa-zv-vz_gesamt.csv",
      "retrieved": "2026-11-04",
      "attribution": "© OeNB, CC BY 4.0"
    },
    "BE": {
      "name": "National Bank of Belgium (NBB)",
      "url": "https://www.nbb.be/doc/be/be/protocol/full_list_current.xlsx",
      "retrieved": "2026-11-04",
      "attribution": "Source: National Bank of Belgium"
    },
    "CH": {
      "name": "SIX Interbank Clearing: Bank Master v3",
      "url": "https://api.six-group.com/api/epcd/bankmaster/v3/bankmaster_V3.csv",
      "retrieved": "2026-11-04",
      "attribution": "Source: SIX Interbank Clearing"
    },
    "CZ": {
      "name": "Česká národní banka (ČNB)",
      "url": "https://www.cnb.cz/cs/platebni-styk/.galleries/ucty_kody_bank/download/kody_bank_CR.csv",
      "retrieved": "2026-11-04",
      "attribution": "Zdroj: ČNB"
    },
    "DE": {
      "name": "Deutsche Bundesbank",
      "url": "https://www.bundesbank.de/resource/blob/926192/2feadedd079726ffbe1eedaf6c74ff76/472B63F073F071307366337C94F8C870/blz-aktuell-csv-data.csv",
      "retrieved": "2026-11-04",
      "attribution": "Quelle: Deutsche Bundesbank"
    },
    "DK": {
      "name": "e-nettet: IBAN Denmark register",
      "url": "https://www.e-nettet.dk/wp-content/uploads/2025/12/IBAN-Denmark-Greenland-and-Faroe-Islands-11-12-2025-v2.0.xlsx",
      "retrieved": "2026-11-04",
      "attribution": "Source: e-nettet"
    },
    "ES": {
      "name": "Banco de España: lista de instituciones financieras monetarias",
      "url": "https://www.bde.es/webbe/en/estadisticas/otras-clasificaciones/clasificacion-entidades/listas-instituciones-financieras/listas-instituciones-financieras-monetarias-pais/lista-mfi-es.csv",
      "retrieved": "2026-11-04",
      "attribution": "Bank names: Banco de España. BIC codes: European Central Bank (ECB). The ECB must be cited as the source."
    },
    "FI": {
      "name": "Finanssiala ry (Finance Finland): Finnish monetary institution codes and BICs",
      "url": "https://www.finanssiala.fi/wp-content/uploads/2026/04/finnish_monetary_institution_codes_and_bics_in_excel_format-26032026.xlsx",
      "retrieved": "2026-11-05",
      "attribution": "Source: Finanssiala ry (Finance Finland)"
    },
    "FO": {
      "name": "e-nettet: IBAN Denmark, Greenland and Faroe Islands register",
      "url": "https://www.e-nettet.dk/wp-content/uploads/2025/12/IBAN-Denmark-Greenland-and-Faroe-Islands-11-12-2025-v2.0.xlsx",
      "retrieved": "2026-11-04",
      "attribution": "Source: e-nettet"
    },
    "FR": {
      "name": "Regafi: ACPR Catalogue Banque register",
      "url": "https://www.regafi.fr/api/explore/v2.1/catalog/datasets/catalogue-banque/exports/csv?select=cib%2Cdenomination%2Cadresse%2Ccode_postal%2Cville&where=cib%20!%3D%20'%5B%5D'",
      "retrieved": "2026-11-04",
      "attribution": "Bank names: Regafi / ACPR (Autorité de contrôle prudentiel et de résolution). BIC codes: European Central Bank (ECB). The ECB must be cited as the source."
    },
    "GL": {
      "name": "e-nettet: IBAN Denmark, Greenland and Faroe Islands register",
      "url": "https://www.e-nettet.dk/wp-content/uploads/2025/12/IBAN-Denmark-Greenland-and-Faroe-Islands-11-12-2025-v2.0.xlsx",
      "retrieved": "2026-11-04",
      "attribution": "Source: e-nettet"
    },
    "LI": {
      "name": "SIX Interbank Clearing: Bank Master v3",
      "url": "https://api.six-group.com/api/epcd/bankmaster/v3/bankmaster_V3.csv",
      "retrieved": "2026-11-04",
      "attribution": "Source: SIX Interbank Clearing"
    },
    "LU": {
      "name": "ABBL Luxembourg Register of IBAN/BIC codes",
      "url": "https://www.abbl.lu/professionals/payments/luxembourg-register-of-iban-bic-codes/",
      "retrieved": "2026-11-04",
      "attribution": "Source: ABBL Luxembourg Register of IBAN/BIC codes"
    },
    "NO": {
      "name": "Bits AS: Norwegian BIC-IBAN table",
      "url": "https://bits.no/document/iban/",
      "retrieved": "2026-11-04",
      "attribution": "Source: Bits AS"
    },
    "PL": {
      "name": "Narodowy Bank Polski: EWIB register (plewibnra.txt)",
      "url": "https://ewib.nbp.pl/faces/pages/daneDoPobrania.xhtml",
      "retrieved": "2026-11-04",
      "attribution": "Source: Narodowy Bank Polski (EWIB)"
    },
    "PT": {
      "name": "European Central Bank: list of Monetary Financial Institutions (MFIs)",
      "url": "https://www.ecb.europa.eu/stats/money/mfi/general/html/dla/mfi_mrr_MID/fi_mrr_csv_261030.csv.gz",
      "retrieved": "2026-11-04",
      "attribution": "Bank names, addresses and BIC codes: European Central Bank (ECB). The ECB must be cited as the source."
    },
    "SE": {
      "name": "Bankinfrastruktur (BSAB) - Swedish IBAN-ID table",
      "url": "https://www.bankinfrastruktur.se/media/rrnhercd/tabell-for-nedladdning.csv",
      "retrieved": "2026-11-04",
      "attribution": "Source: Bankinfrastruktur (BSAB)"
    },
    "SK": {
      "name": "Národná banka Slovenska (NBS)",
      "url": "https://nbs.sk/dokument/53533909-a9c9-4727-8b89-c9fca5e214ca/stiahnut/?force=true",
      "retrieved": "2026-11-04",
      "attribution": "Source: Národná banka Slovenska"
    }
  }
}
