---
title: "Sandbox - ID Verification"
method: POST
path: "/v1/data-verification/id-verification/sandbox"
tags: ["Sandbox - ID Verification"]
---

# Sandbox - ID Verification

`POST /v1/data-verification/id-verification/sandbox`

## Request

- Base URL: `https://api.verihubs.com`
- URL: `https://api.verihubs.com/v1/data-verification/id-verification/sandbox`
- Auth: none declared. Required headers: `App-ID`, `API-Key`

The sandbox for ID Verification Service that enables you to map 1:1 request and response to Live mode.
  
  #### Scenario Description
  Scenario       | Request Payload  (nik, name, birth_date)       | Description |
  -----------|:---------------------|:-------------------------- |
  All data true | 8522011808880001 <br> JOHN DOE <br> 18-08-1988 | Data inputted based on rules & registered in Dukcapil based on NIK|
  NIK not inputted | {empty nik value} <br> JOHN DOE <br> 18-08-1988 | User left nik value empty |
  NIK not numeric | 85220118ABCD0001 <br> JOHN DOE <br> 18-08-1988 | User input non-numeric value to nik field |
  NIK not 16 digit | 852201180888000 <br> JOHN DOE <br> 18-08-1988 | User input just 15 digits number |
  NIK not found in Dukcapil (NIK false) | {input random 16 digits} <br> JOHN DOE <br> 18-08-1988 | NIK inputted not found in Dukcapil database |
  Name empty | 8522011808880001 <br> JOHN DOE <br> 18-08-1988 | User left name value empty |
  Name false | 8522011808880001 <br> {input random name} <br> 18-08-1988 | Name inputted is not an exact match compared to the one registered in Dukcapil database |
  Birth date empty | 8522011808880001 <br> JOHN DOE <br> {empty birth date value} | User left birth date value empty |
  Birth date not DD-MM-YYYY | 8522011808880001 <br> JOHN DOE <br> 1988-08-18 | User use YYYY-MM-DD format |
  Birth date false | 8522011808880001 <br> JOHN DOE <br> {random birth date with DD-MM-YYYY format} | Birth date inputted is not an exact match compared to the one registered in Dukcapil database |

## Headers

- `App-ID` string, required
- `API-Key` string, required

## Request body

- IdVerification
  - `nik` string, required: 16 digit Nomor Induk Kependudukan (NIK) from Kartu Tanda Penduduk (KTP).
  - `name` string, required: Full name from KTP
  - `birth_date` string, required: Date of birth from KTP in DD-MM-YYYY format.
  - `reference_id` string: Use to indicate your company's transaction (must be unique).

## Response `200`

Successful Response

- ResponseIdVerification
  - `message` string, required: Shows message of the response
  - `data` object, required: Shows results of verification
    - `id` string: Verihubs ID, generate string that are unique for every transactions
    - `nik` boolean: nik verification result
    - `name` boolean: name verification result
    - `birth_date` boolean: birth date verification result
    - `reference_id` string

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Unauthorized
- `429`: Unauthorized
- `500`: Internal Server Error

---

[API](https://skmtc.dev/verihubs/apis/sandbox-data-api-documentation.md) - [All operations](https://skmtc.dev/verihubs/apis/sandbox-data-api-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/verihubs/apis/sandbox-data-api-documentation/revisions/64df34f0a428?raw)