मुख्य सामग्री पर जाएं
GET
curl
किसी एक सूची की प्रविष्टियाँ सबसे नई से सबसे पुरानी के क्रम में लौटाएँ, वैकल्पिक खोज के साथ। search प्रविष्टि के मान या लेबल के किसी भाग से मेल खाता है, और इसमें अक्षरों के बड़े-छोटे होने का ध्यान नहीं रखा जाता। reference_session_id परिणामों को उन प्रविष्टियों तक सीमित करता है जो किसी एक सत्यापन सत्र से ली गई हैं। चेहरे की सूची में, metadata.face_image_source बताता है कि प्रत्येक प्रविष्टि सत्र के किस चेहरे से है (अनुपस्थित होने पर liveness)। चेहरे और दस्तावेज़ प्रविष्टियों के metadata में इमेज URL होते हैं, जो कॉल के थोड़ी देर बाद समाप्त हो जाते हैं। इन URL को संग्रहीत करने के बजाय नए URL पाने के लिए प्रविष्टियाँ फिर से लाएँ। media: read के बिना API कुंजी को इन URL के लिए null मिलता है।

प्राधिकरण

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 द्वारा लौटाया गया है।

क्वेरी पैरामीटर

केस-इनसेंसिटिव टेक्स्ट जो प्रविष्टि के value या display_label में होना चाहिए।

reference_session_id
string<uuid>

केवल इस व्यक्ति के सत्यापन सत्र से ली गई प्रविष्टियाँ, उदाहरण के लिए यह देखने के लिए कि इसके कौन से चेहरे पहले से सूचीबद्ध हैं।

limit
integer
डिफ़ॉल्ट:50

पेज का आकार। डिफ़ॉल्ट 50 है। 1000000 से अधिक मान 400 लौटाता है; शून्य, ऋणात्मक या गैर-संख्यात्मक मान 50 पर वापस आ जाता है।

आवश्यक सीमा: 1 <= x <= 1000000
offset
integer
डिफ़ॉल्ट:0

लौटाए जाने वाले पहले आइटम का शून्य-आधारित इंडेक्स। next का अनुसरण करना बेहतर है। 1000000 से अधिक का मान 400 लौटाता है; ऋणात्मक या गैर-संख्यात्मक मान 0 पर वापस चला जाता है।

आवश्यक सीमा: 0 <= x <= 1000000

प्रतिक्रिया

प्रविष्टियों का एक पेज, सबसे नई पहले।

count
integer
आवश्यक

फ़िल्टर से मेल खाने वाली प्रविष्टियों की कुल संख्या।

आवश्यक सीमा: x >= 0
next
string<uri> | null
आवश्यक

अगले पेज का पूर्ण URL, या अंतिम पेज पर null।

previous
string<uri> | null
आवश्यक

पिछले पेज का पूर्ण URL, या पहले पेज पर null।

results
object[]
आवश्यक
अंतिम संशोधन 7 नवंबर 2026