norwegian-social-security-number-validator

a simple validator for validation a norwegian social security numbers (FNR, DNR)

See Fødselsnummer for more info on how validation of a norwegian social security number is done

Supports the following synthetic numbers:

• Norsk Helsenett(nhn)
• Tenor (skatteetaten)
• Dolly (Nav)

Technologies used

• Kotlin
• Gradle
• JDK 25

Using the library

import

Note Find the newest version of the libary here: https://central.sonatype.com/artifact/io.github.mikaojk/norwegian-social-security-number-validator and swap it out with the version(2.0.9) in the examples below

Gradle

implementation("io.github.mikaojk:norwegian-social-security-number-validator:2.0.9")

Maven

<dependency>
  <groupId>io.github.mikaojk</groupId>
  <artifactId>norwegian-social-security-number-validator</artifactId>
  <version>2.0.9</version>
</dependency>

Use example

    val validSocialSecurityNumber = validateSocialSecurityNumber("01013999900")

    if (validSocialSecurityNumber) {
        println("valid social securityNumber")
    } else {
        println("illegal social securityNumber")
    }

Local development

Prerequisites

Make sure you have the Java JDK 25 installed You can check which version you have installed using this command:

java -version

Running the application

Build and run tests

To build locally and run the integration tests you can simply run

./gradlew clean build

or on windows gradlew.bat clean build

Upgrading the gradle wrapper

Find the newest version of gradle here: https://gradle.org/releases/ Then run this command:

./gradlew wrapper --gradle-version $gradleVersjon

Publish of artifact

Artifact publish is done by GitHub Actions, and published to Maven Central

Contact

This project is maintained by CODEOWNERS

Questions and/or feature requests? Please create an issue

✏️ Contributing

To get started, please fork the repo and checkout a new branch. See more info in CONTRIBUTING.md