README

Identity data reader based on NIK (Nomor Induk Kependudukan)

About

This library gives you a way to convert the NIK number into useful information such as: Region name (province, city, sub-district), date of birth, gender, zodiac, age, and more. This can also be used to validate whether the NIK number is valid or not. Here is the example result :

{
    "valid": true,
    "nik": "3502200101000001",
    "province_id": "35",
    "province": "JAWA TIMUR",
    "city_id": "3502",
    "city": "KAB. PONOROGO",
    "subdistrict_id": "350220",
    "subdistrict": "JAMBON",
    "postal_code": "63456",
    "date_of_birth": "01-01-2000",
    "age": {
        "year": 21,
        "month": 9,
        "day": 25
    },
    "zodiac": "Capricorn",
    "gender": "male",
    "unique_code": "0001"
}

Installation

1. Run command

composer require zerosdev/nik-reader

Usage

Laravel

// .........
public function method()
{
    $nik = '3502200101910001';
    $result = \NikReader::read($nik);

    if (true === $result->valid) {
        // code
    }
}

Non-Laravel

<?php

require 'path/to/your/vendor/autoload.php';

use ZerosDev\NikReader\Reader;

$nik = '3502200101910001';
$reader = new Reader();
$result = $reader->read($nik);

if (true === $result->valid) {
    // code
}

Reading Multiple NIKs

When reading multiple NIKs, you have two options:

Option 1: Using the same instance (recommended)

$reader = new Reader();

// Read first NIK
$result1 = $reader->read('3502200101910001');
echo $result1->date_of_birth; // 01-01-1991

// Read second NIK (overwrites previous data)
$result2 = $reader->read('3502201101910001');
echo $result2->date_of_birth; // 11-01-1991

// Note: $result1 and $result2 are the same object!

Available Methods