{"id":41783762,"url":"https://github.com/anjulapaulus/iban-api","last_synced_at":"2026-01-25T04:07:23.331Z","repository":{"id":39654476,"uuid":"496902663","full_name":"anjulapaulus/iban-api","owner":"anjulapaulus","description":"This api ifor validating IBAN numbers.","archived":false,"fork":false,"pushed_at":"2022-05-29T07:25:36.000Z","size":23,"stargazers_count":1,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"main","last_synced_at":"2024-06-20T00:27:10.822Z","etag":null,"topics":["clean-architecture","go","golang","iban","iban-validator","rest-api","restful-api"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/anjulapaulus.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2022-05-27T07:32:25.000Z","updated_at":"2023-03-05T07:12:06.000Z","dependencies_parsed_at":"2022-09-17T15:13:32.177Z","dependency_job_id":null,"html_url":"https://github.com/anjulapaulus/iban-api","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/anjulapaulus/iban-api","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/anjulapaulus%2Fiban-api","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/anjulapaulus%2Fiban-api/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/anjulapaulus%2Fiban-api/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/anjulapaulus%2Fiban-api/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/anjulapaulus","download_url":"https://codeload.github.com/anjulapaulus/iban-api/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/anjulapaulus%2Fiban-api/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28742983,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-25T02:46:29.005Z","status":"ssl_error","status_checked_at":"2026-01-25T02:44:29.968Z","response_time":113,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["clean-architecture","go","golang","iban","iban-validator","rest-api","restful-api"],"created_at":"2026-01-25T04:07:22.834Z","updated_at":"2026-01-25T04:07:23.325Z","avatar_url":"https://github.com/anjulapaulus.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![Pipeline](https://github.com/anjulapaulus/iban-api/actions/workflows/go.yml/badge.svg)](https://github.com/anjulapaulus/iban-api/actions/workflows/go.yml)\n[![codecov](https://codecov.io/gh/anjulapaulus/iban-api/branch/main/graph/badge.svg?token=gpb1RqnMrx)](https://codecov.io/gh/anjulapaulus/iban-api)\n[![Go Report Card](https://goreportcard.com/badge/github.com/anjulapaulus/iban-api)](https://goreportcard.com/report/github.com/anjulapaulus/iban-api)\n\n# IBAN API\n\nThis api is responsible in validating IBAN numbers.\n\n## \u003cb\u003eAlgorithm \u003c/b\u003e\n1. Check that the total IBAN length is correct as per the country. If not, the IBAN is invalid.\n2. Move the four initial characters to the end of the string.\n3. Replace each letter in the string with two digits, thereby expanding the string, where A = 10, B = 11, ..., Z = 35.\n4. Interpret the string as a decimal integer and compute the remainder of that number on division by 97\n\nIf the remainder is 1, the check digit test is passed and the IBAN might be valid. \n\nReference:  https://en.wikipedia.org/wiki/International_Bank_Account_Number#Structure\n\n## \u003cb\u003eBuild\u003c/b\u003e\n\n### \u003cb\u003eMakefile\u003c/b\u003e\nBuild binary for specific OS.\n```\n# Build for Windows\nmake build_windows\n\n# Build for Linux\nmake build_linux\n\n# Build for Darwin (macOS)\nmake build_darwin\n```\nBuild binary based on local OS.\n\n```\nmake build\n\n# Could build and run binary\nmake build_and_run\n```\n\nRemove binaaries built\n```\nmake clean\n```\n### \u003cb\u003eDocker\u003c/b\u003e\nCreating a container and running the API.\n```\nmake docker_run\n```\nStop and remove container.\n```\nmake docker_rm\n```\n\n## \u003cb\u003eTests\u003c/b\u003e\n\nRun the unit tests using make.\n\n```\nmake test\n```\n\n## \u003cb\u003eUsage\u003c/b\u003e\n\n```\nPOST 127.0.0.1:3000/valid/iban\n```\nHeader\n```\nContent-Type: application/json\n```\nRequest Body\n\n```\n{\n    \"iban\":\"VG96VPVG00000L2345678901\"\n}\n```\n\nSuccess Response - 200\n```\n{\n    \"valid\": false\n}\n```\n\nError Response - 400\n```\n{\n    \"type\": \"\",\n    \"code\": \"\",\n    \"message\": \"\"\n}\n```","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fanjulapaulus%2Fiban-api","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fanjulapaulus%2Fiban-api","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fanjulapaulus%2Fiban-api/lists"}