> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# API Daftar Blokir & Daftar Izin Didit

> Kelola daftar blokir, daftar izin, dan daftar kustom Didit untuk KYC, fraud, dan skrining transaksi. Infrastruktur identitas all-in-one, bayar per panggilan.



Prompt Lists API
        Salin prompt ke papan klip



      
      

\<pre>

\`Manage Didit blocklists, allowlists, and custom lists through the Management API.

Base path:
https://verification.didit.me/v3/lists/

Authentication:
Use the x-api-key header with my Didit API key on every call.

Concepts:
\- Blocklist — system-created, one per entry type. Items in a blocklist cause automatic decline during verification or transaction screening. Cannot be deleted or renamed.
\- Allowlist: created by you, or by Didit as a system allowlist that cannot be renamed or deleted. Used in workflow conditions and to suppress duplicate/reuse actions for trusted matching items.
\- Custom — user-created. Flexible lists for workflow branching, monitoring rules, or manual review.

Supported entry_type values:
face, document, phone, email, ip_address, device_fingerprint, wallet_address, bank_account, user, business, country, key.

Endpoints I should know:
\- GET /v3/lists/ — list all lists (filter by list_type, entry_type).
\- POST /v3/lists/ — create allowlist or custom list (cannot create blocklists).
\- GET /v3/lists/{list_uuid}/ — get one list.
\- PATCH /v3/lists/{list_uuid}/ — rename or update description (system lists immutable).
\- DELETE /v3/lists/{list_uuid}/ — delete allowlist/custom only. Returns 204.
\- GET /v3/lists/{list_uuid}/entries/ — paginated entries; supports search query.
\- POST /v3/lists/{list_uuid}/entries/ — add an entry by value, by reference_session_id, or by reference_object_uuid + metadata.reference_type ("transaction" | "vendor_user" | "vendor_business").
\- POST /v3/lists/{list_uuid}/entries/face-upload/: upload a base64 face image to a face blocklist or face allowlist; Didit extracts the biometric.
\- DELETE /v3/lists/{list_uuid}/entries/{entry_uuid}/ — remove an entry. For system blocklists this auto-unblocks the underlying entity.

Value validation (Create entry):
\- email — valid email address.
\- phone — valid international phone number (auto-normalized to E.164).
\- ip_address — IP or CIDR range (e.g. 10.0.0.0/8).
\- device_fingerprint: at least 8 characters among letters, digits, -, _, : and . (a blocklist refuses a fingerprint that several distinct devices have reported).
\- country — ISO 3166-1 alpha-3 (alpha-2 is accepted and converted).
\- Other types — any non-empty string. Values are case-insensitive and normalized on storage.

Traceability:
\- Pass reference_session_id when blocklisting from a verification session: Didit auto-extracts the right value (face/document/phone/email/IP/device), marks the underlying model as blocklisted, and links the entry back to the session. Didit reads the session's most recent record of that type; to list a value from an earlier record, add it by value without reference_session_id.
\- Pass reference_object_uuid plus metadata.reference_type ("transaction" | "vendor_user" | "vendor_business") when blocklisting from a transaction or vendor user/business so the console can link back to the source.

Common failure modes:
\- 400: value fails the entry_type validator or is already in the list, list_type is wrong for the operation (e.g. POST face-upload on a non-face list), reference_session_id has no data of the requested type, a system list is modified or deleted, or a list name is already used in this application (on create or rename).
\- 401: the API key has expired.
\- 403: missing x-api-key (a wrong, revoked or expired key gets 401) ({ "detail": "You do not have permission to perform this action." }), or a scoped key without workflows access.
\- 404: list or entry not found in this application (a list of another application also returns 404).

Side effects:
\- Adding to a system blocklist immediately blocks future matches at verification/screening time.
\- Deleting an entry from a system blocklist unblocks the matching entity.
\- Lists are referenced by workflow status_rules (value_type: "list") for runtime list checks.

For the full integration shape (auth, retries, error handling), see /integration/integration-prompt.`

\</pre>



      
      

Tempel ke

Lists API memungkinkan Anda mengelola daftar bertipe untuk aplikasi Anda. Daftar blokir sistem dibuat dan diperiksa secara otomatis selama verifikasi dan skrining transaksi. Anda juga dapat membuat daftar izin dan daftar kustom untuk kondisi alur kerja.## Konsep| Jenis | Deskripsi |
| - | - |
| **Daftar blokir** | Dibuat oleh sistem, satu untuk setiap jenis entri. Item dalam daftar blokir menyebabkan penolakan otomatis selama verifikasi atau skrining transaksi. |
| **Daftar izin** | Dibuat oleh pengguna. Digunakan dalam kondisi alur kerja dan untuk menekan tindakan duplikat/penggunaan ulang bagi item yang cocok dan tepercaya. |
| **Kustom** | Dibuat oleh pengguna. Fleksibel untuk percabangan alur kerja, aturan pemantauan, atau peninjauan manual. |## Jenis entri| Jenis entri | Diperiksa selama | Saat cocok |
| - | - | - |
| `face` | Verifikasi liveness | Sesi ditolak |
| `document` | Verifikasi identitas (OCR) | Sesi ditolak |
| `phone` | Verifikasi Telepon | Sesi ditolak |
| `email` | Verifikasi Email | Sesi ditolak |
| `ip_address` | Analisis Perangkat & IP (mendukung rentang CIDR) | Sesi ditolak |
| `device_fingerprint` | Analisis Perangkat & IP | Sesi ditolak |
| `wallet_address` | Skrining transaksi | Transaksi ditolak |
| `bank_account` | Skrining transaksi | Transaksi ditolak |
| `user` | Skrining transaksi | Pengguna diblokir |
| `business` | Skrining transaksi | Bisnis diblokir |
| `country` | Kondisi alur kerja | Dapat dikonfigurasi |
| `key` | Penggunaan kustom | Dapat dikonfigurasi |## Daftar izinDaftar izin tidak menimpa daftar blokir atau pemeriksaan keaslian. Daftar izin hanya menekan tindakan duplikat/penggunaan ulang untuk jenis entri yang sama. Misalnya, wajah dalam daftar izin wajah dapat melewati tindakan `DUPLICATED_FACE`, IP dalam daftar izin IP dapat melewati tindakan `DUPLICATED_IP_ADDRESS`, dan sidik jari perangkat dalam daftar izin perangkat dapat melewati tindakan `DUPLICATED_DEVICE_FINGERPRINT`. Didit tetap mencatat peringatan informasional daftar izin agar Anda dapat mengaudit alasan tindakan duplikat tidak dijalankan.## Daftar blokir sistemSetiap aplikasi otomatis mendapatkan 10 daftar blokir sistem (satu untuk setiap jenis entri yang didukung) dan satu daftar sistem **High Risk Countries**. Daftar ini tidak dapat dihapus atau diganti namanya. Anda dapat menambahkan entri ke daftar tersebut melalui API atau dari konsol.## KetertelusuranSetiap entri daftar blokir dapat ditautkan kembali ke entitas sumbernya sehingga Anda dapat berpindah dari daftar ke catatan asli:- **Dari sesi**: teruskan `reference_session_id` saat [membuat entri](https://docs.didit.me/id/management-api/lists/create-entry.md). Didit secara otomatis mengekstrak nilai (wajah, dokumen, telepon, email, IP, atau perangkat), menandai model yang mendasarinya sebagai masuk daftar blokir, dan menautkan entri kembali ke sesi. Didit membaca catatan terbaru dari jenis tersebut dalam sesi. Untuk mencantumkan nilai dari catatan sebelumnya, tambahkan nilainya melalui `value` tanpa `reference_session_id`.
- **Dari transaksi, pengguna, atau bisnis**: teruskan `reference_object_uuid` dengan UUID entitas tersebut dan sertakan `metadata.reference_type` (`"transaction"`, `"vendor_user"`, atau `"vendor_business"`) agar konsol dapat menautkan kembali ke catatan asli.## Endpoint> [card] [Daftar semua daftar](https://docs.didit.me/id/management-api/lists/list.md)
>
> Ambil semua daftar untuk sebuah aplikasi.> [card] [Daftar entri](https://docs.didit.me/id/management-api/lists/list-entries.md)
>
> Ambil entri dalam sebuah daftar.> [card] [Buat entri](https://docs.didit.me/id/management-api/lists/create-entry.md)
>
> Tambahkan nilai ke daftar blokir: berdasarkan nilai, referensi sesi, atau referensi transaksi.> [card] [Hapus entri](https://docs.didit.me/id/management-api/lists/delete-entry.md)
>
> Hapus entri dan buka blokir entitas yang mendasarinya.> [card] [Unggah wajah](https://docs.didit.me/id/management-api/lists/upload-face.md)
>
> Unggah gambar wajah langsung ke daftar blokir wajah.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.