Langsung ke konten utama
GET
curl
Dapatkan detail satu daftar, termasuk jumlah entrinya dan kapan entri terbarunya ditambahkan. Daftar milik aplikasi lain, atau daftar yang telah dihapus, mengembalikan 404. Untuk membaca nilai dalam daftar, gunakan Entri daftar.

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

list_uuid
string<uuid>
wajib

UUID daftar, seperti yang dikembalikan oleh Cantumkan daftar atau Buat daftar.

Respons

Daftar tersebut.

Daftar blokir, daftar izin, atau daftar kustom dari satu aplikasi.

uuid
string<uuid>
wajib

Pengidentifikasi daftar. Gunakan ini sebagai list_uuid di endpoint daftar dan entri, serta sebagai nilai dari kondisi aturan alur kerja atau transaksi dengan value_type: "list".

name
string
wajib

Nama daftar, unik di antara daftar milik aplikasi.

Maximum string length: 255
description
string
wajib

Deskripsi teks bebas. String kosong jika tidak diatur.

list_type
enum<string>
wajib

blocklist: kecocokan akan menolak sesi atau transaksi (hanya daftar sistem, satu per tipe entri). allowlist: item yang cocok dipercaya, misalnya allowlist wajah melewati tindakan untuk wajah duplikat; tidak pernah menimpa kecocokan daftar blokir. custom: digunakan dalam kondisi aturan alur kerja dan transaksi (value_type: "list").

Opsi yang tersedia:
blocklist,
allowlist,
custom
entry_type
enum<string>
wajib

Apa yang dimuat dalam daftar: face, document (nomor dokumen), phone, email, ip_address (alamat atau rentang CIDR), device_fingerprint, wallet_address, bank_account, country (ISO 3166-1 alpha-3), user atau business (vendor_data Anda), atau key (string apa pun). Ini menentukan cara nilai entri divalidasi dan dicocokkan.

Opsi yang tersedia:
face,
document,
phone,
email,
ip_address,
device_fingerprint,
wallet_address,
bank_account,
country,
user,
business,
key
is_system
boolean
wajib

true untuk daftar yang disediakan oleh Didit: satu daftar blokir per tipe entri (face, document, phone, email, ip_address, device_fingerprint, wallet_address, bank_account, user, business), daftar kustom Negara Berisiko Tinggi, dan daftar izin sistem. Daftar sistem tidak dapat diganti namanya, diedit, atau dihapus; Anda dapat menambahkan dan menghapus entrinya.

entry_count
integer
wajib

Jumlah entri yang saat ini ada dalam daftar.

Rentang yang diperlukan: x >= 0
last_entry_added_at
string<date-time> | null
wajib

Waktu entri saat ini yang terbaru ditambahkan. null untuk daftar kosong.

created_at
string<date-time>
wajib

Waktu daftar dibuat.

updated_at
string<date-time>
wajib

Waktu daftar terakhir diperbarui.

Terakhir diubah pada 7 November 2026