Langsung ke konten utama
GET
curl

Ikhtisar

Mengembalikan satu entitas Pengguna yang diidentifikasi berdasarkan vendor_data. Respons menyertakan didit_internal_id, yaitu pengidentifikasi internal yang stabil dari Didit.

Kapan menggunakannya

  • Pencarian status verifikasi terkini seorang pengguna. Objek features memberi Anda status terbaru dari setiap fitur dalam satu objek.
  • Tampilan detail di UI Anda sendiri. Ambil profil sesuai permintaan sebelum merendernya.
  • Penilaian risiko: gabungkan penghitung sesi dan features untuk memberi skor pada setiap pengguna di sisi Anda.

Catatan

  • vendor_data di URL bersifat peka huruf besar-kecil.
  • Mengembalikan 404 jika tidak ada pengguna dengan vendor_data tersebut dalam aplikasi.
  • Penghitung agregat (session_count, approved_count, declined_count, in_review_count) diperbarui secara real time saat sesi selesai.
  • Lihat model data Pengguna untuk setiap kolom.

Izin

Setiap kunci API aktif dari aplikasi dapat memanggil endpoint ini. Kunci API Didit bersifat terikat aplikasi, bukan terikat peran: peran dan izin di Console (read:users dan lainnya) menentukan apa yang dapat dilakukan seseorang di Console, dan tidak dievaluasi untuk lalu lintas Management API. Atur siapa yang dapat memanggil endpoint ini dengan mengatur siapa yang dapat membaca kunci API aplikasi.

Terkait

Otorisasi

x-api-key
string
header
wajib

Kunci API aplikasi Anda, dari Developers -> API keys di Business Console. Kunci utama memiliki akses penuh. Kunci bernama dapat diberi cakupan: none, read, atau write per sumber daya, dibatasi pada beberapa alur kerja atau pada sesi yang disetujui, pada daftar alamat IP, dan pada tanggal kedaluwarsa. 401 berarti kuncinya salah, dicabut, atau kedaluwarsa; 403 berarti tidak ada kunci yang dikirimkan, kunci tidak memiliki akses ke sumber daya atau tindakan ini, atau permintaan datang dari alamat di luar daftar IP-nya; 404 pada rute sesi berarti sesi berada di luar alur kerja atau status kunci tersebut. Kunci tanpa akses media menerima URL gambar, video, dan PDF sebagai null, dan kunci tanpa izin tulis sesi menerima tautan sesi dan token sebagai null. Lihat https://docs.didit.me/console/api-keys.

Parameter Path

vendor_data
string
wajib

Pengidentifikasi unik Anda untuk pengguna — string bentuk bebas (BUKAN UUID). Ini adalah nilai yang sama dengan yang Anda teruskan sebagai vendor_data saat membuat sesi yang pertama kali memperkenalkan pengguna ini, dicocokkan persis seperti yang dikirim.

Respons

Detail pengguna lengkap termasuk metadata, log komentar/aktivitas, dan data sesi gabungan.

Detail pengguna lengkap. Memperluas UserListItem dengan metadata, komentar, dan updated_at.

didit_internal_id
string<uuid>

UUID internal yang stabil dari Didit untuk pengguna ini.

vendor_data
string | null

Pengidentifikasi unik Anda untuk pengguna ini (diteruskan saat membuat sesi). Nilai ini dapat berupa null jika tidak ada pengidentifikasi vendor yang diberikan.

display_name
string | null

Nama tampilan kustom yang Anda tetapkan

full_name
string | null

Nama lengkap yang diekstrak dari dokumen yang diverifikasi

date_of_birth
string<date> | null
effective_name
string | null

Nama terbaik yang tersedia: display_name jika disetel, selain itu full_name

status
enum<string>

Status siklus hidup rekaman pengguna (BUKAN status sesi). ACTIVE adalah default, FLAGGED menandai pengguna untuk perhatian manual, BLOCKED mencegah sesi baru untuk vendor_data ini.

Opsi yang tersedia:
ACTIVE,
FLAGGED,
BLOCKED
portrait_image_url
string | null

URL presigned untuk foto potret pengguna (kedaluwarsa setelah beberapa jam)

session_count
integer

Jumlah total sesi verifikasi untuk pengguna ini

approved_count
integer

Jumlah sesi yang disetujui

declined_count
integer

Jumlah sesi yang ditolak

in_review_count
integer

Jumlah sesi dalam peninjauan

issuing_states
string[]

Kode ISO 3166-1 alpha-3 dari negara penerbit yang terlihat pada dokumen ID pengguna yang disetujui ini, misalnya ["USA", "ESP"]. Berupa array kosong jika tidak ada.

approved_emails
string[]

Alamat email terverifikasi yang dikumpulkan dari sesi pengguna ini yang disetujui, contoh ["john@example.com"].

approved_phones
string[]

Nomor telepon terverifikasi yang dikumpulkan dari sesi pengguna ini yang disetujui, contoh ["+14155551234"].

features
object

Status per-fitur agregat di semua sesi pengguna ini. Kunci yang memungkinkan: ID_VERIFICATION, NFC, LIVENESS, FACE_MATCH, POA, QUESTIONNAIRE, EMAIL_VERIFICATION, PHONE, AML, IP_ANALYSIS, AGE_ESTIMATION, DATABASE_VALIDATION. Nilai yang memungkinkan: Approved, Declined, In Review, Not Finished, Resub Requested.

features_list
object[]

Data yang sama dengan features, sebagai array berurutan dari objek {feature, status}.

last_session_at
string<date-time> | null

Cap waktu sesi terbaru

first_session_at
string<date-time> | null

Cap waktu sesi pertama

last_activity_at
string<date-time> | null

Cap waktu aktivitas terbaru pada pengguna ini (sesi, transaksi, perubahan status, pengeditan data, dll.).

tags
object[]

Penetapan tag. CATATAN: pada respons detail, setiap entri berupa objek tautan tag ({uuid, tag: {...}, added_by_email, added_by_name, created_at}), berbeda dengan format datar {uuid, name, color} yang digunakan pada respons daftar.

created_at
string<date-time>
metadata
object

JSON metadata kustom yang Anda lampirkan ke pengguna ini. Default adalah {}.

comments
object[]

Log aktivitas dan komentar untuk pengguna ini (perubahan status, pengeditan profil, catatan manual).

updated_at
string<date-time>
Terakhir diubah pada 7 November 2026