bsantanna/iban-validator-model repository overview

⁠IBAN Validator Model

This is an open-source project⁠ which delivers a machine learning model⁠ for validating IBAN⁠ account numbers accessible via gRPC⁠ and REST⁠ APIs.

⁠Container startup

To run this image with Docker use the following command:

$ docker run -it --rm -p 41151:41151 -p 8080:8080 bsantanna/iban-validator-model

After some moments a container should spawn two processes:

• A Python gRPC⁠ listening on port 41151.
• A Spring Boot / Java REST API⁠ listening on port 8080.

⁠Model usage

With example IBAN accounts from https://bank.codes⁠.

IBAN to validation data JSON:

$ curl -s \
  "http://localhost:8080/validation?iban=BR1800000000141455123924100C2"

Gives the following result output:

{
  "classification": {
    "bban_regex": "[0-9]{23}[A-Z]{1}[A-Za-z0-9]{1}",
    "check_digit_regex": "[0-9][0-9]",
    "code": "BR",
    "country": "Brazil",
    "size": 29
  },
  "description": "IBAN passed validation",
  "iban": "BR1800000000141455123924100C2",
  "is_valid": true
}

⁠License

Distributed under the Apache License 2.0⁠.

The project source code is available at bsantanna/iban-validator-model⁠ Github repository.

For reporting errors or questions please contact me by e-mail⁠

Copyright 2022 Bruno César Brito Sant’Anna⁠