Langsung ke konten utama
POST
curl
Buat daftar untuk aplikasi Anda. Hanya daftar allowlist dan custom yang dapat dibuat: Didit menyediakan satu daftar blokir sistem untuk setiap jenis entri, dan Anda menambahkan entri ke daftar tersebut dengan Buat entri. Pilih entry_type dengan hati-hati: nilainya tidak dapat diubah nanti, dan nilai ini menentukan bagaimana setiap nilai divalidasi saat Anda menambahkannya. Lihat Daftar untuk mengetahui fungsi setiap jenis 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.

Body

application/json
name
string
wajib

Nama daftar. Harus berbeda dari nama setiap daftar lain di aplikasi, termasuk daftar sistem.

Required string length: 1 - 255
list_type
enum<string>
wajib

allowlist atau custom. blocklist ditolak dengan kode 400.

Opsi yang tersedia:
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. Tidak dapat diubah nanti.

Opsi yang tersedia:
face,
document,
phone,
email,
ip_address,
device_fingerprint,
wallet_address,
bank_account,
country,
user,
business,
key
description
string
default:""

Deskripsi teks bebas opsional.

Respons

Daftar telah dibuat.

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