curl -X GET 'https://verification.didit.me/v3/lists/11111111-2222-3333-4444-555555555555/entries/?search=example.com' \
-H 'x-api-key: YOUR_API_KEY'from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
for item in client.lists.entries.list(
"11111111-2222-3333-4444-555555555555",
):
print(item)import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
for await (const item of didit.lists.entries.list("11111111-2222-3333-4444-555555555555")) {
console.log(item);
}ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
iter := client.Lists.Entries.ListAutoPaging(ctx, "11111111-2222-3333-4444-555555555555", didit.ListsEntriesListParams{})
for iter.Next() {
fmt.Printf("%+v\n", iter.Current())
}
if err := iter.Err(); err != nil {
log.Fatal(err)
}import me.didit.Didit;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
for (var item : client.lists().entries().list("11111111-2222-3333-4444-555555555555")) {
System.out.println(item);
}<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
foreach ($didit->lists->entries->list('11111111-2222-3333-4444-555555555555') as $item) {
print_r($item->toArray());
}require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
didit.lists.entries.list("11111111-2222-3333-4444-555555555555").auto_paging_each do |item|
puts item.to_h
endusing System;
using System.Text.Json;
using Didit;
// Reads DIDIT_API_KEY.
using var client = new DiditClient();
await foreach (var item in await client.Lists.Entries.ListAsync("11111111-2222-3333-4444-555555555555"))
{
Console.WriteLine(JsonSerializer.Serialize(item));
}{
"count": 2,
"next": null,
"previous": null,
"results": [
{
"uuid": "bbbbbbbb-cccc-dddd-eeee-ffffffffffff",
"value": "X1234567",
"display_label": "Jane Doe - X1234567",
"comment": "",
"added_by": "api",
"reference_session_id": "33333333-4444-5555-6666-777777777777",
"reference_session_number": 1042,
"reference_session_type": "kyc",
"reference_object_uuid": "66666666-7777-8888-9999-000000000000",
"metadata": {
"full_name": "Jane Doe",
"issuing_state": "ESP",
"document_type": "ID",
"region": "",
"document_number": "X1234567"
},
"created_at": "2026-10-12T10:06:12.774915Z"
},
{
"uuid": "eeeeeeee-ffff-0000-1111-222222222222",
"value": "y7654321",
"display_label": "",
"comment": "Reported by a partner",
"added_by": "api",
"reference_session_id": null,
"reference_session_number": null,
"reference_session_type": null,
"reference_object_uuid": null,
"metadata": null,
"created_at": "2026-10-03T07:48:30.552810Z"
}
]
}ब्लॉकलिस्ट और Allowlist आइटम: List Entries API
GET /v3/lists//entries/: खोज फ़िल्टर के साथ Didit की ब्लॉकलिस्ट, allowlist या कस्टम सूची की पेजिनेटेड प्रविष्टियाँ प्राप्त करें। प्रति कॉल भुगतान।
curl -X GET 'https://verification.didit.me/v3/lists/11111111-2222-3333-4444-555555555555/entries/?search=example.com' \
-H 'x-api-key: YOUR_API_KEY'from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
for item in client.lists.entries.list(
"11111111-2222-3333-4444-555555555555",
):
print(item)import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
for await (const item of didit.lists.entries.list("11111111-2222-3333-4444-555555555555")) {
console.log(item);
}ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
iter := client.Lists.Entries.ListAutoPaging(ctx, "11111111-2222-3333-4444-555555555555", didit.ListsEntriesListParams{})
for iter.Next() {
fmt.Printf("%+v\n", iter.Current())
}
if err := iter.Err(); err != nil {
log.Fatal(err)
}import me.didit.Didit;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
for (var item : client.lists().entries().list("11111111-2222-3333-4444-555555555555")) {
System.out.println(item);
}<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
foreach ($didit->lists->entries->list('11111111-2222-3333-4444-555555555555') as $item) {
print_r($item->toArray());
}require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
didit.lists.entries.list("11111111-2222-3333-4444-555555555555").auto_paging_each do |item|
puts item.to_h
endusing System;
using System.Text.Json;
using Didit;
// Reads DIDIT_API_KEY.
using var client = new DiditClient();
await foreach (var item in await client.Lists.Entries.ListAsync("11111111-2222-3333-4444-555555555555"))
{
Console.WriteLine(JsonSerializer.Serialize(item));
}{
"count": 2,
"next": null,
"previous": null,
"results": [
{
"uuid": "bbbbbbbb-cccc-dddd-eeee-ffffffffffff",
"value": "X1234567",
"display_label": "Jane Doe - X1234567",
"comment": "",
"added_by": "api",
"reference_session_id": "33333333-4444-5555-6666-777777777777",
"reference_session_number": 1042,
"reference_session_type": "kyc",
"reference_object_uuid": "66666666-7777-8888-9999-000000000000",
"metadata": {
"full_name": "Jane Doe",
"issuing_state": "ESP",
"document_type": "ID",
"region": "",
"document_number": "X1234567"
},
"created_at": "2026-10-12T10:06:12.774915Z"
},
{
"uuid": "eeeeeeee-ffff-0000-1111-222222222222",
"value": "y7654321",
"display_label": "",
"comment": "Reported by a partner",
"added_by": "api",
"reference_session_id": null,
"reference_session_number": null,
"reference_session_type": null,
"reference_object_uuid": null,
"metadata": null,
"created_at": "2026-10-03T07:48:30.552810Z"
}
]
}search प्रविष्टि के मान या लेबल के किसी भाग से मेल खाता है, और इसमें अक्षरों के बड़े-छोटे होने का ध्यान नहीं रखा जाता। reference_session_id परिणामों को उन प्रविष्टियों तक सीमित करता है जो किसी एक सत्यापन सत्र से ली गई हैं। चेहरे की सूची में, metadata.face_image_source बताता है कि प्रत्येक प्रविष्टि सत्र के किस चेहरे से है (अनुपस्थित होने पर liveness)।
चेहरे और दस्तावेज़ प्रविष्टियों के metadata में इमेज URL होते हैं, जो कॉल के थोड़ी देर बाद समाप्त हो जाते हैं। इन URL को संग्रहीत करने के बजाय नए URL पाने के लिए प्रविष्टियाँ फिर से लाएँ। media: read के बिना API कुंजी को इन URL के लिए null मिलता है।प्राधिकरण
आपकी एप्लिकेशन की 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।
पथ पैरामीटर
सूची का UUID, जैसा कि List lists या Create a list द्वारा लौटाया गया है।
क्वेरी पैरामीटर
केस-इनसेंसिटिव टेक्स्ट जो प्रविष्टि के value या display_label में होना चाहिए।
केवल इस व्यक्ति के सत्यापन सत्र से ली गई प्रविष्टियाँ, उदाहरण के लिए यह देखने के लिए कि इसके कौन से चेहरे पहले से सूचीबद्ध हैं।
पेज का आकार। डिफ़ॉल्ट 50 है। 1000000 से अधिक मान 400 लौटाता है; शून्य, ऋणात्मक या गैर-संख्यात्मक मान 50 पर वापस आ जाता है।
1 <= x <= 1000000लौटाए जाने वाले पहले आइटम का शून्य-आधारित इंडेक्स। next का अनुसरण करना बेहतर है। 1000000 से अधिक का मान 400 लौटाता है; ऋणात्मक या गैर-संख्यात्मक मान 0 पर वापस चला जाता है।
0 <= x <= 1000000प्रतिक्रिया
प्रविष्टियों का एक पेज, सबसे नई पहले।