IDVS – Enhanced Data Verification with Selfie Request

POST https://sandbox.boiva.id/b2b/v1/identity-verification

IDVS is an API endpoint designed to verify Indonesian identity data using NIK (National Identity Number), full name, and selfie photo for face matching.

---

Supported Verification:

• Verifies the user’s NIK, Full Name, DOB, and Selfie Photo.
• In addition to the basic data verification (IDVB), this type includes selfie verification to confirm the authenticity and validity of the provided photo against citizenship records.
• IDVS conducts data verification against citizenship records and includes a selfie check to confirm the photo’s authenticity and match it with the registered identity. For detailed pricing information, please contact BOIVA directly.

---

Request Parameters

Key Parameters	Data Type	Description	Required
Authorization	String	Public Access Token	Yes
type	String	Supported type verification. Use IDVS	Yes
ktp	String	User's NIK (ID Number) to be verified against citizenship data	Yes
fullname	String	User's fullname to be verified against citizenship data	Yes
birth_date	String	Format: yyyy-mm-dd. If omitted, derived from NIK	Optional
birth_place	String	User's birth place to be verified against citizenship data	Optional
selfie_photo	String	User's selfie photo to be verified against citizenship data in Base64 format	Yes

⚠️ If birth_date is not sent, the system will derive it from the NIK. If there’s a mismatch with official records, the response may include normalized = true

---

Response Parameters

Field	Type	Description
ktp	Boolean	Whether the NIK matches government records
fullname	Boolean	Whether the full name matches government records
birth_date	Boolean	Whether the birth date matches (or is derived and matches)
birth_place	Boolean	Whether the birth place matches government records (if requested)
gender	String	1 for Male, 0for Female (status= Boolean )
address	String	Address generated from NIK
selfie_photo	Boolean	Whether the selfie photo matches the official image
normalized	Boolean	true if the date of birth was derived from NIK and did not match

🚧

Understanding normalized

The normalized field indicates a potential discrepancy between the user-provided or system-derived birth date and the official government records.

This situation may arise when:

• The population registry has updated or corrected a citizen's birth record (e.g., from Dukcapil).
• The client does not send a birth_date, and the system attempts to derive it from the NIK.
• The inferred date based on the NIK structure differs from the actual official birth date.

ℹ️ Statistically, this occurs in approximately 6–8% of verification cases and is considered normal, especially for older or previously migrated registry data.

Example Scenario:
You send only NIK and Full Name without birth_date.
The system derives the birth date from NIK → compares it to official data → mismatch → normalized = true.

Decision Table

NIK Match	Fullname Match	Birth Date Sent	Birth Date Match	normalized
✅	✅	❌	❌ (derived)	true
✅	✅	✅	✅	(no return)
✅	✅	✅	❌	(no return)
✅	✅	❌	✅ (derived)	false

---

Guidelines for Selfie Verification

To ensure accurate verification, please adhere to the following guidelines when submitting a selfie photo:

1. Lighting and Positioning:
   • Ensure adequate lighting to clearly capture facial features.
   • Position the face level with the camera, keeping the head centered in the frame.
2. Distance and Background:
   • Maintain a moderate distance from the camera — not too close and not too far.
   • Use a plain, uncluttered background to minimize distractions.
3. Appearance and Accessories:
   • Avoid wearing accessories that may obscure facial features (e.g., sunglasses, masks).
   • If wearing a hijab, ensure that the forehead and cheeks are visible.
4. Photo Authenticity:
   • The person in the selfie must be the same as the individual associated with the NIK data submitted.
   • The photo must not be altered or digitally modified.
5. Image Specifications:
   • Accepted formats: jpg, jpeg, png.
   • Maximum file size: 5MB.
6. Image Dimensions and Cropping:
   • Minimum dimensions: 800px width x 600px height.
   • If the submitted photo is larger than the required dimensions, the system will automatically crop from the center: 300px Up, 300px Down, 400px Left, and 400px Right.
   • Photos smaller than the specified dimensions will be rejected.
     Adhering to these guidelines will ensure optimal processing and accurate verification of the submitted selfie photo. For further assistance, please contact Brick support.

Example Photo

Correct Image - Forward-facing photo, clear and good lighting

‎‎‎‎‎‎‎‎

‎‎‎‎

‎‎‎

Incorrect Image - Not clear and bad lighting