Langsung ke konten utama
GET
curl

Ikhtisar

Mengembalikan daftar entitas pengguna yang dibagi per halaman untuk aplikasi yang terautentikasi. Gunakan endpoint ini untuk menyinkronkan pengguna ke gudang data Anda, menemukan pengguna yang memerlukan perhatian analis, atau mencari berdasarkan nama tampilan.

Kapan menggunakannya

  • Sinkronisasi berkala tabel pengguna Anda ke BI eksternal atau gudang data.
  • Antrean analis: filter berdasarkan status=FLAGGED atau last_activity_at yang sudah lama untuk mengisi kotak masuk peninjauan.
  • Cari pengguna berdasarkan display_name, full_name, atau vendor_data.

Filter dan paginasi

Catatan

  • Setiap item respons menyertakan didit_internal_id. vendor_data dapat bernilai null jika sesi atau transaksi asli tidak menyediakannya.
  • Endpoint ini melakukan paginasi menggunakan kursor: simpan kursor next di antara pemanggilan dan hentikan ketika next kosong.
  • Lihat model data pengguna untuk semua kolom pada baris pengguna.

Izin

Setiap kunci API aktif milik aplikasi dapat memanggil endpoint ini. Kunci API Didit bersifat berbasis aplikasi, bukan berbasis peran: peran dan izin di Console (list: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 Query

limit
integer
default:50

Ukuran halaman. Nilai default-nya 50 jika dihilangkan. Tidak ada batasan maksimum yang diterapkan, tetapi jaga ukuran halaman tetap kecil demi latensi.

Rentang yang diperlukan: 1 <= x <= 1000000
offset
integer
default:0

Offset berbasis nol dari rekaman pertama yang dikembalikan. Sebaiknya ikuti URL next dari halaman sebelumnya daripada menghitungnya secara manual.

Rentang yang diperlukan: 0 <= x <= 1000000

Respons

Daftar pengguna berpaginasi dengan status verifikasi, jumlah sesi, dan rincian fitur.

count
integer

Jumlah baris yang cocok — tepat hingga 100, dibatasi pada 100 setelahnya demi performa. Jangan gunakan ini untuk mendeteksi halaman terakhir; andalkan next yang bernilai null sebagai gantinya.

next
string | null

URL absolut halaman berikutnya, atau null di halaman terakhir.

previous
string | null

URL absolut halaman sebelumnya, atau null di halaman pertama.

results
object[]
Terakhir diubah pada 7 November 2026