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"
}
]
}List Entries API: Blocklist & Allowlist Items
GET /v3/lists//entries/: retrieve paginated entries in a Didit blocklist, allowlist, or custom list with search filtering. Pay-per-call.
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 matches part of an entry’s value or label without regard to case; reference_session_id narrows the results to the entries taken from one verification session. On a face list, metadata.face_image_source tells which of the session’s faces each entry is (liveness when absent).
Face and document entries carry image URLs in metadata that expire shortly after the call. Fetch the entries again for fresh URLs rather than storing them. An API key without media: read receives null for those URLs.Authorizations
Your application's API key, from Developers -> API keys in the Business Console. The primary key has full access. A named key can be scoped: none, read or write per resource, limited to some workflows or to approved sessions, to a list of IP addresses, and to an expiry date. 401 means the key is wrong, revoked or expired; 403 means no key was sent, the key has no access to this resource or action, or the request came from an address outside its IP list; 404 on a session route means the session is outside the key's workflows or statuses. A key without media access receives image, video and PDF URLs as null, and a key without sessions write receives session links and tokens as null. See https://docs.didit.me/console/api-keys.
Path Parameters
Query Parameters
Response
A page of entries, newest first.