Verifikasi Identitas identity.ktp.verify

NIK Validation

POST /api/v1/kyc/identity/validate-official

Verifikasi kecocokan NIK, Nama Lengkap, dan Tanggal Lahir langsung terhadap database kependudukan nasional resmi.

Body parameters

Kirim sebagai JSON body atau multipart payload. Field yang ditandai required wajib diisi.

Name	Type	Required	Description
`nik`	string	required	Nomor Induk Kependudukan 16 digit.
`name`	string	required	Nama lengkap sesuai dokumen KTP.
`date_of_birth`	string	optional	Tanggal lahir format DD-MM-YYYY untuk mempersempit pencarian.

Headers

Headers berikut wajib disertakan pada setiap request ke endpoint ini.

Name	Required	Description
`X-API-Key`	required	Secret Key untuk server-to-server API.
`Content-Type`	required	application/json atau multipart/form-data sesuai kebutuhan endpoint.

Responses

Status code mengikuti pola umum OGI. Detail field response mengikuti jenis endpoint dan contoh di panel kanan.

Code	Status	Deskripsi
`200`	OK	Request berhasil diproses.
`400`	Bad Request	Payload tidak valid (field hilang/format salah).
`401`	Unauthorized	API key tidak valid atau tidak disertakan.
`429`	Too Many Requests	Rate limit terlampaui.
`500`	Internal Server Error	Kesalahan internal sistem.

Siap mengevaluasi?

Hubungi tim solusi kami untuk akses evaluasi teknis dan diskusi integrasi.

Diskusikan Kebutuhan Kembali ke ringkasan

Contoh request 200 OK

POST /api/v1/kyc/identity/validate-official

request

curl -X POST https://api.orbitglobalinformasi.com/api/v1/kyc/identity/validate-official \
  -H "X-API-Key: sk_test_..." \
  -H "Content-Type: application/json" \
  -d '{"nik":"3276000000000001","name":"BUDI SANTOSO","date_of_birth":"01-01-1990"}'

await fetch('https://api.orbitglobalinformasi.com/api/v1/kyc/identity/validate-official', {
  method: 'POST',
  headers: {
    'X-API-Key': process.env.OGI_API_KEY,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    nik: '3276000000000001',
    name: 'BUDI SANTOSO',
    date_of_birth: '01-01-1990'
  })
});

$ch = curl_init('https://api.orbitglobalinformasi.com/api/v1/kyc/identity/validate-official');
curl_setopt_array($ch, [
  CURLOPT_POST => true,
  CURLOPT_POSTFIELDS => json_encode([
    'nik' => '3276000000000001',
    'name' => 'BUDI SANTOSO',
    'date_of_birth' => '01-01-1990'
  ]),
  CURLOPT_HTTPHEADER => [
    'X-API-Key: ' . $_ENV['OGI_API_KEY'],
    'Content-Type: application/json'
  ],
  CURLOPT_RETURNTRANSFER => true,
]);

Response

application/json

{
  "status": "success",
  "provider": "dukapi",
  "http_status": 200,
  "request_payload": {
    "NIK": "3276000000000001",
    "NAMA_LGKP": "BUDI SANTOSO",
    "TGL_LHR": "01-01-1990",
    "TRESHOLD": "100"
  },
  "result": {
    "verified": true
  },
  "error": null
}

{
  "error": "field 'NIK' must be 16 digits"
}

Required headers

X-API-Key required
Content-Type required