stdnum-clj

Unified validation, parsing, and formatting of standard identifier numbers for Clojure - credit cards, IBAN/BIC, ISBN, ISSN, ISIN, US bank routing (ABA), IMEI, and the raw Luhn check, behind one small API.

Stack

Unofficial, community-maintained. Not affiliated with Apache, iban4j, or any card network.

Why

Clojure has plenty of one-identifier libraries (an IBAN parser here, a Luhn checker there), most of them tiny and unmaintained, each with its own API. There was no single library that validates the common, checksummable identifiers under one consistent interface - the way Python's python-stdnum does. stdnum-clj is that facade. For the international identifiers it wraps the maintained Apache Commons Validator and iban4j engines rather than reinventing them, so those checks are as correct as those libraries and stay correct as they're updated. A few global and national standards with public, well-documented algorithms (LEI, Brazil CPF/CNPJ) are implemented clean-room and kept under this library's EPL license.

Install

Leiningen / Boot:

[net.clojars.savya/stdnum-clj "0.3.0"]

deps.edn:

net.clojars.savya/stdnum-clj {:mvn/version "0.3.0"}

Usage

(require '[stdnum.core :as stdnum])

;; valid? - dispatch on an identifier-type keyword
(stdnum/valid? :iban "GB82 WEST 1234 5698 7654 32")  ;=> true
(stdnum/valid? :credit-card "4111 1111 1111 1111")   ;=> true (spaces/hyphens tolerated)
(stdnum/valid? :isbn "978-0-306-40615-7")            ;=> true
(stdnum/valid? :iban "GB82 WEST 1234 5698 7654 33")  ;=> false (bad check digit)

;; parse - validity plus the useful extracted fields
(stdnum/parse :credit-card "378282246310005")
;=> {:valid? true, :network :amex}
(stdnum/parse :iban "GB82WEST12345698765432")
;=> {:valid? true, :country "GB", :bban "WEST12345698765432",
;    :formatted "GB82 WEST 1234 5698 7654 32"}
(stdnum/parse :isin "US0378331004")
;=> {:valid? false}

;; format - canonical human form (nil if invalid)
(stdnum/format :iban "GB82WEST12345698765432")  ;=> "GB82 WEST 1234 5698 7654 32"
(stdnum/format :credit-card "4111111111111111")  ;=> "4111 1111 1111 1111"

;; detect - which types consider this value valid
(stdnum/detect "4111111111111111")  ;=> [:credit-card :luhn]
(stdnum/detect "nonsense")          ;=> []

;; global / national identifiers (LEI, Brazil CPF/CNPJ, ...)
(stdnum/valid? :lei "5493001KJTIIGC8Y1R12")  ;=> true
(stdnum/valid? :br-cpf "111.444.777-35")     ;=> true
(stdnum/format :br-cnpj "11222333000181")    ;=> "11.222.333/0001-81"

;; convenience
(stdnum/card-network "6011111111111117")  ;=> :discover
stdnum/types  ;=> #{:credit-card :iban :bic :isbn :issn :isin :aba :imei :luhn
              ;     :lei :cusip :sedol :br-cpf :br-cnpj :us-ssn :us-ein}

valid?, parse, and format throw IllegalArgumentException only on an unknown identifier type (a programming bug). Bad data never throws: valid? returns false, parse returns {:valid? false}, format returns nil.

Supported identifiers

Type	Meaning	Engine
:credit-card	Card number + network (Visa/Mastercard/Amex/Discover/Diners)	Commons Validator
:iban	International Bank Account Number (+ country/BBAN)	iban4j
:bic	Bank Identifier Code (SWIFT)	iban4j
:isbn	ISBN-10 and ISBN-13	Commons Validator
:issn	International Standard Serial Number	Commons Validator
:isin	International Securities Identification Number	Commons Validator
:aba	US bank routing number (ABA)	Commons Validator
:imei	Mobile device IMEI (Luhn over 15 digits)	Commons Validator
:luhn	Raw Luhn (mod-10) check	Commons Validator
:lei	Legal Entity Identifier (ISO 17442)	clean-room
:cusip	CUSIP securities identifier (US/Canada)	Commons Validator
:sedol	SEDOL securities identifier (UK/Ireland)	Commons Validator
:br-cpf	Brazil individual taxpayer registry (CPF)	clean-room
:br-cnpj	Brazil company registry (CNPJ)	clean-room
:us-ssn	US Social Security Number (structural rules)	clean-room
:us-ein	US Employer Identification Number	clean-room

Global and national identifiers whose algorithms are public, well-documented standards are implemented clean-room (no third-party port) and stay under this library's EPL license. Country-specific formats are keyed by an ISO-3166 prefix (e.g. :br-cpf). More are added on demand - open an issue for an identifier you need.

License

Copyright (c) 2026 Savyasachi. Released under the Eclipse Public License 1.0.