Isikukood NPM | npm.io

Estonian personal ID (isikukood)

JavaScript class for both browser and Node. Generates and validates Estonian personal IDs.

Check demo

Version 3

Fully backwards compatible with previous major versions 2.x.x and 1.x.x.
Migrated to TypeScript.
Removed CommonJS support, use ESModules.

Version 2

Fully backwards compatible with previous major versions 1.x.x.

Install

Install via npm, yarn or pnpm.

npm install isikukood
yarn install isikukood
pnpm install isikukood

Download and include JS file into your HTML.

<script src="./dist/isikukood.esm.js" type="module"></script>

Using ES Modules

import {Isikukood} from './dist/isikukood.esm.js';

Usage

Usage example.

// Validation
const ik = new Isikukood('47502124911');
const isValid = ik.validate(); // true is valid, false isn't valid
const sex = ik.getGender(); // "male" or "female"
const age = ik.getAge(); // person's age
const birthday = ik.getBirthday(); // person's birthday

// Generation
const validIk = Isikukood.generate(); // "49002124277"

// Generate with parameters
const maleIk = Isikukood.generate({
  gender: 'male',
  birthDay: 23,
  birthMonth: 3,
  birthYear: 1984,
});

API

Instance methods

Method	Description	Arguments	Return
new Isikukood()	constructor	number \| string	Isikukood
validate()	Validates personal ID	-	boolean
generate()	Static function generates a valid personal ID	GenerateInput	string
getGender()	Get the gender of a person	-	Gender
getBirthday()	Get the birthday of a person	-	Date
getAge()	Get the birthday of a person in years	-	number
getControlNumber()	Gets the control number of personal ID	-	number
parse()	Parses the code	-	PersonalData