1.17.0: 8 July 2026

1.17.0: 8 July 2026

• Update to IBAN.com Experimental List, contributed by @legopiraat #229
  • Albania (AL): is now SEPA
  • Moldova (MB): is now SEPA
  • Montenegro (ME): is now SEPA
  • Macedonia (MK): is now SEPA
  • Serbia (RS): is now SEPA

Maven

    <dependency>
        <groupId>nl.garvelink.oss</groupId>
        <artifactId>iban</artifactId>
        <version>1.17.0</version>
    </dependency>

Gradle

    dependencies {
        compile 'nl.garvelink.oss:iban:1.17.0'
    }

Sbt

libraryDependencies += "nl.garvelink.oss" % "iban" % "1.17.0"

1.16.0: 22 December 2025

1.16.0: 22 December 2025

• Updates to IBAN Registry revision 99
  • Honduras (HN): added
  • Portugal (PT): add branch identifier
  • Yemen (YE): added
• Update to IBAN.com Experimental List
  • Honduras (HN): removed

1.15.0: 31 May 2024

1.15.0: 31 May 2024

• Updates to IBAN Registry revision 97
  • Falkland Islands (FK): added
  • Oman (OM): added
• Bug fix: non-serializable instance field in IBANException.
• Maintenance: switch from nexus-staging-maven-plugin to central-publishing-maven-plugin.
• Signing GPG key ID 1573BDA099E1C39C631B2D8B5240D7B0FDC662CC.

1.14.0: 18 May 2023

• Fixes exception when composing IBAN with check digit under 10 (#92).
• Update to revision 94 of the SWIFT IBAN Registry
  • Mongolia (MN): added
  • Nicaragua (NI): added, note that this entry was previously in the experimental list, and the IBAN length has changed.
  • Somalia (SO): added
• Update to IBAN.com Experimental List
  • Nicaragua (NI): removed

1.13.0: 16 September 2022

• All exceptions thrown now extend IBANException (#17)
• No changes to country data

1.12.0: 27 May 2022

• Update to revision 92 of the SWIFT IBAN Registry
  • Djibouti (DJ): added
  • Russia (RU): added
  • Sudan (SU): remove incorrect branch identifier field
• Update to IBAN.com Experimental List
  • Djibouti (DJ): removed

1.11.0: 26 November 2021

• Update to revision 91 of the SWIFT IBAN Registry
  • Burundi (BI): added
• Update to IBAN.com Experimental List
  • Burundi (BI): removed

1.10.1: 20 August 2021

• Update to revision 90 of the SWIFT IBAN Registry
  • Sudan (SD): added (#42).
• Update to IBAN.com Experimental List
  • No changes
• Drop template-maven-plugin. It has proven to make the CI build very flaky. Removing this also lets us remove the third-party artifact repository from the pom (#33), simplifying the supply chain. It also makes the build a little quicker. The downside is that the build now requires Python 3 and a bourne shell. It should build on WSL2 just fine, but there is no pom profile to support Windows native builds.

1.9.0: 3 April 2021

• Compatible change: utility functions in CountryCodes now accept java.lang.CharSequence (was String).
• New API method: IBAN.compose(CharSequence, CharSequence).
• New API method: Modulo97.calculateCheckDigits(CharSequence, CharSequence).
• France (FR): add branch identifier (#30)
• Update to revision 89 of the SWIFT IBAN Registry
  • Andorra (AD): is now SEPA
• Update to IBAN.com Experimental List
  • No changes
• The project can now be compilead on Adopt-OpenJDK 11 HS. An outdated library used in the code generation step prevented this.
• The @javax.annotation.Generated annotation has been removed from the CountryCodesData class. This annotation moved into a library package in newer Java versions, and does not justify taking on a library dependency.

1.8.0: 21 November 2020

• The IBAN class implements java.io.Serializable (#23). The serialized form should stay valid across library version updates. There is one obvious backwards-incompatibility: deserializing after a version downgrade, of an IBAN whose country only exists in the newer version, will fail.
• No updates to reference data.