मुख्य सामग्री पर जाएं
GET
curl
किसी एक सूची का विवरण प्राप्त करें, जिसमें उसकी प्रविष्टियों की संख्या और सबसे नई प्रविष्टि कब जोड़ी गई थी, यह भी शामिल है। किसी दूसरे एप्लिकेशन की सूची, या हटाई गई सूची के लिए 404 लौटाया जाता है। सूची के मान पढ़ने के लिए सूची प्रविष्टियाँ का उपयोग करें।

प्राधिकरण

x-api-key
string
header
आवश्यक

आपकी एप्लिकेशन की API कुंजी, Business Console में Developers -> API keys से। प्राथमिक कुंजी के पास पूर्ण एक्सेस होता है। एक नामित कुंजी को स्कोप किया जा सकता है: प्रति संसाधन none, read या write, कुछ वर्कफ़्लो या स्वीकृत सत्रों तक सीमित, IP पतों की सूची तक सीमित, और समाप्ति तिथि तक सीमित। 401 का अर्थ है कि कुंजी गलत है, निरस्त कर दी गई है या उसकी समय-सीमा समाप्त हो गई है; 403 का अर्थ है कि कोई कुंजी नहीं भेजी गई थी, कुंजी के पास इस संसाधन या कार्रवाई का एक्सेस नहीं है, या अनुरोध उसकी IP सूची से बाहर के पते से आया था; सत्र रूट पर 404 का अर्थ है कि सत्र कुंजी के वर्कफ़्लो या स्थितियों से बाहर है। मीडिया एक्सेस के बिना एक कुंजी को छवि, वीडियो और PDF URL null के रूप में प्राप्त होते हैं, और सत्र write के बिना एक कुंजी को सत्र लिंक और token null के रूप में प्राप्त होते हैं। देखें https://docs.didit.me/console/api-keys।

पथ पैरामीटर

list_uuid
string<uuid>
आवश्यक

सूची का UUID, जैसा कि List lists या Create a list द्वारा लौटाया गया है।

प्रतिक्रिया

सूची।

एक एप्लिकेशन की ब्लॉकलिस्ट, allowlist या कस्टम सूची।

uuid
string<uuid>
आवश्यक

सूची पहचानकर्ता। इसे सूची और प्रविष्टि endpoint में list_uuid के रूप में, और value_type: "list" के साथ वर्कफ़्लो या लेन-देन नियम शर्त के मान के रूप में उपयोग करें।

name
string
आवश्यक

सूची का नाम, एप्लिकेशन की सूचियों के बीच अद्वितीय।

Maximum string length: 255
description
string
आवश्यक

मुक्त-पाठ विवरण। सेट न होने पर खाली स्ट्रिंग।

list_type
enum<string>
आवश्यक

blocklist: एक मिलान सत्र या लेन-देन को अस्वीकार कर देता है (केवल सिस्टम सूचियां, प्रति प्रविष्टि प्रकार एक)। allowlist: मिलान करने वाले आइटम विश्वसनीय होते हैं, उदाहरण के लिए एक फ़ेस अनुमति सूची डुप्लिकेट-फ़ेस कार्रवाई को छोड़ देती है; कभी भी ब्लॉकलिस्ट मिलान को ओवरराइड नहीं करती। custom: वर्कफ़्लो और लेन-देन नियम शर्तों में उपयोग किया जाता है (value_type: "list")।

उपलब्ध विकल्प:
blocklist,
allowlist,
custom
entry_type
enum<string>
आवश्यक

सूची में क्या समाहित है: face, document (दस्तावेज़ संख्या), phone, email, ip_address (IP पता या CIDR रेंज), device_fingerprint, wallet_address, bank_account, country (ISO 3166-1 alpha-3), user या business (आपका vendor_data), या key (कोई भी स्ट्रिंग)। यह तय करता है कि प्रविष्टि मानों को कैसे मान्य और मिलान किया जाता है।

उपलब्ध विकल्प:
face,
document,
phone,
email,
ip_address,
device_fingerprint,
wallet_address,
bank_account,
country,
user,
business,
key
is_system
boolean
आवश्यक

Didit द्वारा प्रदान की जाने वाली सूचियों के लिए true: प्रत्येक प्रविष्टि प्रकार (face, document, phone, email, ip_address, device_fingerprint, wallet_address, bank_account, user, business) के लिए एक ब्लॉकलिस्ट, High Risk Countries कस्टम सूची, और सिस्टम अनुमत सूचियाँ। सिस्टम सूचियों का नाम बदला, संपादित या हटाया नहीं जा सकता; आप उनकी प्रविष्टियाँ जोड़ और हटा सकते हैं।

entry_count
integer
आवश्यक

वर्तमान में सूची में प्रविष्टियों की संख्या।

आवश्यक सीमा: x >= 0
last_entry_added_at
string<date-time> | null
आवश्यक

नवीनतम वर्तमान प्रविष्टि कब जोड़ी गई थी। खाली सूची के लिए null।

created_at
string<date-time>
आवश्यक

सूची कब बनाई गई थी।

updated_at
string<date-time>
आवश्यक

सूची अंतिम बार कब अपडेट की गई थी।

अंतिम संशोधन 7 नवंबर 2026