---
title: "ID Verification Service"
method: POST
path: "/data-verification/id-verification/verify"
tags: ["ID Verification Service"]
---

# ID Verification Service

`POST /data-verification/id-verification/verify`

## Request

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

The ID Verification service validate the personal identity of your user in a quick and efficient way to protect your business from potential fraud. We provide you a simple API that can be quickly tested and integrated. Please check the details below on the components of our API.

## Headers

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

## Request body

- IDV
  - `nik` string, required: 16 digit of Nomor Induk Kependudukan on Kartu Tanda Penduduk (KTP).
  - `name` string, required: Full name based on KTP.
  - `birth_date` string, required: Date of birth based on KTP.
  - `reference_id` string: This reference_id can be used to indicate your company’s transaction (must be unique per transaction).

## Response `200`

Successful Response

- ResponseIDV
  - `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 checking result. It will return true or false.
    - `name` boolean: Name checking result. It will return true or false.
    - `birth_date` boolean: Birth date checking result. It will return true or false.
    - `reference_id` string: Client inputted ID. Will be autogenerated if empty.

## Other responses

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

---

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