---
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`

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/sms-api-documentation.md) · [All operations](https://skmtc.dev/verihubs/apis/sms-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/verihubs/sms-api-documentation/revisions/5fa885d38adc/schema)