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"
}
]
}リストエントリーAPI:ブロックリスト・許可リストの項目取得
GET /v3/lists//entries/:Diditのブロックリスト、許可リスト、カスタムリストのエントリーを検索フィルター付きでページネーション取得します。呼び出しごとの従量課金です。
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を指定すると、1つの認証セッションから取り込まれたエントリーに結果を絞り込めます。顔リストでは、metadata.face_image_sourceにより、各エントリーがセッション内のどの顔に対応するかがわかります(存在しない場合はliveness)。
顔と書類のエントリーは、metadataに画像URLを含みます。これらのURLは呼び出しから間もなく期限切れになります。URLを保存せず、新しいURLが必要なときはエントリーを再度取得してください。media: readを持たないAPIキーでは、これらのURLはnullとして返されます。承認
お客様のアプリケーションのAPIキーです。Business ConsoleのDevelopers -> API keysで取得できます。プライマリキーはフルアクセス権を持ちます。名前付きキーにはスコープを設定できます。リソースごとのアクセス権(なし、読み取り、書き込み)、一部のワークフローまたは承認済みセッションへの限定、IPアドレスのリストへの限定、有効期限の設定です。401は、キーが誤っている、失効している、または期限切れであることを意味します。403は、キーが送信されていない、キーにこのリソースやアクションへのアクセス権がない、またはIPリスト外のアドレスからリクエストが送信されたことを意味します。セッションのルートでの404は、セッションがキーのワークフローまたはステータスの対象外であることを意味します。メディアへのアクセス権がないキーでは、画像、動画、PDFのURLがnullで返されます。セッションの書き込み権限がないキーでは、セッションのリンクとトークンがnullで返されます。詳細は次を参照してください: https://docs.didit.me/console/api-keys
パスパラメータ
リストのUUIDです。List listsまたはCreate a listで返される値を指定します。
クエリパラメータ
エントリーのvalueまたはdisplay_labelに含まれている必要がある、大文字・小文字を区別しないテキスト。
この本人認証セッションから取得されたエントリのみ。例えば、そのセッションの顔のうちどれがすでに登録されているかを確認する場合に使用します。
ページサイズ。デフォルトは50です。1000000を超える値は400を返します。0、負の値、数値以外の値の場合は50が使用されます。
1 <= x <= 1000000返す最初の項目の0始まりのインデックスです。nextをたどる方法を推奨します。1000000を超える値は400を返し、負の値または数値以外の値は0として扱われます。
0 <= x <= 1000000