curl -X GET 'https://verification.didit.me/v3/lists/11111111-2222-3333-4444-555555555555/' \
-H 'x-api-key: YOUR_API_KEY'from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.lists.retrieve(
"11111111-2222-3333-4444-555555555555",
)
print(result)import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
const result = await didit.lists.retrieve("11111111-2222-3333-4444-555555555555");
console.log(result);ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
result, err := client.Lists.Retrieve(ctx, "11111111-2222-3333-4444-555555555555")
if err != nil {
log.Fatal(err)
}
fmt.Printf("%+v\n", result)import me.didit.Didit;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
var result = client.lists().retrieve("11111111-2222-3333-4444-555555555555");
System.out.println(result);<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
$result = $didit->lists->retrieve('11111111-2222-3333-4444-555555555555');
print_r($result->toArray());require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
result = didit.lists.retrieve("11111111-2222-3333-4444-555555555555")
puts result.to_husing System;
using System.Text.Json;
using Didit;
// Reads DIDIT_API_KEY.
using var client = new DiditClient();
var result = await client.Lists.RetrieveAsync("11111111-2222-3333-4444-555555555555");
Console.WriteLine(JsonSerializer.Serialize(result));{
"uuid": "11111111-2222-3333-4444-555555555555",
"name": "Face Blocklist",
"description": "Blocked biometric faces. When a face matching an entry in this list is detected during liveness verification, the session will be automatically declined.",
"list_type": "blocklist",
"entry_type": "face",
"is_system": true,
"entry_count": 12,
"last_entry_added_at": "2026-10-09T16:42:03.118204Z",
"created_at": "2026-01-14T10:02:11.402917Z",
"updated_at": "2026-01-14T10:02:11.402917Z"
}API Ambil Daftar: Detail Daftar Kepatuhan
Ambil detail daftar blokir, daftar izin, atau daftar kustom Didit lewat GET /v3/lists//, termasuk jumlah entri dan metadata.
curl -X GET 'https://verification.didit.me/v3/lists/11111111-2222-3333-4444-555555555555/' \
-H 'x-api-key: YOUR_API_KEY'from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.lists.retrieve(
"11111111-2222-3333-4444-555555555555",
)
print(result)import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
const result = await didit.lists.retrieve("11111111-2222-3333-4444-555555555555");
console.log(result);ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
result, err := client.Lists.Retrieve(ctx, "11111111-2222-3333-4444-555555555555")
if err != nil {
log.Fatal(err)
}
fmt.Printf("%+v\n", result)import me.didit.Didit;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
var result = client.lists().retrieve("11111111-2222-3333-4444-555555555555");
System.out.println(result);<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
$result = $didit->lists->retrieve('11111111-2222-3333-4444-555555555555');
print_r($result->toArray());require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
result = didit.lists.retrieve("11111111-2222-3333-4444-555555555555")
puts result.to_husing System;
using System.Text.Json;
using Didit;
// Reads DIDIT_API_KEY.
using var client = new DiditClient();
var result = await client.Lists.RetrieveAsync("11111111-2222-3333-4444-555555555555");
Console.WriteLine(JsonSerializer.Serialize(result));{
"uuid": "11111111-2222-3333-4444-555555555555",
"name": "Face Blocklist",
"description": "Blocked biometric faces. When a face matching an entry in this list is detected during liveness verification, the session will be automatically declined.",
"list_type": "blocklist",
"entry_type": "face",
"is_system": true,
"entry_count": 12,
"last_entry_added_at": "2026-10-09T16:42:03.118204Z",
"created_at": "2026-01-14T10:02:11.402917Z",
"updated_at": "2026-01-14T10:02:11.402917Z"
}404.
Untuk membaca nilai dalam daftar, gunakan Entri daftar.Otorisasi
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
UUID daftar, seperti yang dikembalikan oleh Cantumkan daftar atau Buat daftar.
Respons
Daftar tersebut.
Daftar blokir, daftar izin, atau daftar kustom dari satu aplikasi.
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".
Nama daftar, unik di antara daftar milik aplikasi.
255Deskripsi teks bebas. String kosong jika tidak diatur.
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").
blocklist, allowlist, custom 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.
face, document, phone, email, ip_address, device_fingerprint, wallet_address, bank_account, country, user, business, key 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.
Jumlah entri yang saat ini ada dalam daftar.
x >= 0Waktu entri saat ini yang terbaru ditambahkan. null untuk daftar kosong.
Waktu daftar dibuat.
Waktu daftar terakhir diperbarui.