Introducing VIDA Identity Stack: All of VIDA, in one place 🎉
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Demographic Verification

The Demographic Verification score depends on the provided NIK, full name and DOB.

Incase of Success

NIK Number
UserName
DOB

3511000101806300

UserGDAA

YYYY-MM-DD

1980-01-01

3511000101806301

UserGDAB

YYYY-MM-DD

1980-01-01

Invalid Full Name

NIK Number
UserName
DOB

3511000101806300

UserGDP

YYYY-MM-DD

1980-01-01

3511000101806301

User

YYYY-MM-DD

1980-01-01

Invalid Date of Birth

Change the date of birth in any of the above sets also to test the invalid date of the birth error.

NIK Number
UserName
DOB

3511000101806300

UserGDAA

YYYY-MM-DD

1992-05-2

3511000101806301

UserGDAB

YYYY-MM-DD

1992-05-21

Mock data for extended-demographic parameters

To get full detail of possible enumerations of Extended demographic parameters, please contact VIDA solution team.

To test the extended-demographic parameters, use the mock data as provided in the table.

Mother's maiden name, Address, Area, and Place of Birth

The last 4 characters of the provided mock data are variables and depends upon the last 4 digits of the provided NIK number. Each number 0-9 will map to a character A-J. Example: 0000 is AAAA and 0123 is ABCD.

In case of the last 4 digit of NIK is 7001

  • Mother's maiden name format will be IBUHAAB

  • Place of Birth format will be KotaHAAB

  • Address format will be AddrHAAB

  • Area format will be

    • Province (Provinsi): ProvHAAB

    • City (Kota/Kabupaten): CityHAAB

    • District (Kecamatan): DistHAAB

    • Village (Desa/Kelurahan): VilHAAB

Family Card Number

The family card mock value in Sandbox is equal to provided govId

Marital Status, Gender, and Occupation

Marital status, gender, and occupation are verified against a list of predefined enumeration, based on authoritative sources' possible values.

In sandbox, if the request field is equal to any of the listed enumeration below, then that parameter verification will be accepted.

In production, the requested field will be checked against actual user data. The possible enumerations remains the same with sandbox.

Parameter
Enumeration

Gender

LAKI-LAKI

PEREMPUAN

Marital Status

BELUM KAWIN

KAWIN

CERAI HIDUP

CERAI MATI

Occupation

Please ask the full list to VIDA solution team

DOB

From the mock NIK : 5th and 6th digit indicated birth year.

  • If 5 and 6 th digits are 00 : thenDOB year should be less than 2000

  • If 5 and 6 th digits are 01 : thenDOB year should be greater than 2000

For example : 3511001305248001 : DOB will be 13-05-1924 For example : 3511011305248001 : DOB will be 13-05-2024

Area Code

When an extended demographic check for Area Code is configured (Village No., District No. City No., Province No.), the digit inside the NIK acts as the reference Area Code to compare with the API response.

For any given mock NIK, each group of digits represents a specific personal identifier. The breakdown is as follows:

  • First and second digits (1–2): Indicate the Province Code.

  • Third and fourth digits (3–4): Indicate the City Code.

  • Fifth and sixth digits (5–6): Indicate the District Code.

    • This digit also impacts the mock user century of birth in DOB, where 00 equals to born year of 1900s, and 01 indicates born year of 2000s

  • Last four digits: Indicate the Village Code.

    • Last four digit also impact the mock user full name

For integration purpose, please request the full list of Area Code & area name to VIDA solution team.

Putting all together..

Below are the possible extended demographic check sample that can be verified with VIDA, and its sample value given a certain government ID number.

Parameter
Mock Value

Mandatory Check

govId

3511011305107001

fullName

UserHAAB

dob

13/05/2010

selfiePhoto

As provided in base64, photo will match as long as liveness is passed

Extended Demographic Check

pob

KotaHAAB

gender

LAKI-LAKI

maritalStatus

KAWIN

motherMaidenName

IBUHAAB

address

AddrHAAB

familyCardNo

3511011305107001 (Same as govId)

provinceCode

35

province

ProvHAAB

cityCode

11

city

CityHAAB

districtCode

01

district

DistHAAB

villageCode

7001

village

VilHAAB

Last updated