> ## Documentation Index > Fetch the complete documentation index at: https://docs.didit.me/llms.txt > Use this file to discover all available pages before exploring further. # API Entri Daftar: Item Daftar Blokir & Daftar Izin > Ambil entri berhalaman dari daftar blokir, izin, atau kustom Didit dengan filter. GET /v3/lists/{list_uuid}/entries/. Bayar per panggilan. Prompt API Daftar Entri Salin prompt ke papan klip \

\`Retrieve paginated entries from a Didit list through the Management API.

Endpoint:
GET https://verification.didit.me/v3/lists/{list_uuid}/entries/

Authentication:
Use the x-api-key header with my Didit API key. A scoped API key needs workflows: read.

Goal:
\- Browse, search, or export the entries inside a specific list (blocklist, allowlist, or custom).

Path parameter:
\- list_uuid: the list UUID from GET /v3/lists/.

Query parameters (all optional):
\- search: case-insensitive text that value or display_label must contain.
\- reference_session_id: only the entries taken from this person verification session (for example, to see which of its faces are already in the face blocklist). Must be a session UUID.
\- limit: page size (default 50, at most 1000000).
\- offset: pagination offset (default 0).

Behavior:
\- Current entries only, newest first.
\- Image URLs in metadata (reference_image_url, front_image_url) are short-lived signed URLs, issued again on every call. A scoped key without media: read gets null in their place.

Example call:
curl -X GET "https://verification.didit.me/v3/lists/{list_uuid}/entries/?search=example.com" \
-H "x-api-key: YOUR_API_KEY"

What to read from the response:
\- count / next / previous: standard pagination envelope.
\- results[].uuid: entry id; use it as entry_uuid in DELETE /v3/lists/{list_uuid}/entries/{entry_uuid}/.
\- results[].value: the listed value (phone number in E.164, email, document number, IP or CIDR range, wallet address, country code, vendor_data, or a face UUID on face lists). Matching is case-insensitive.
\- results[].display_label, comment: labels and notes.
\- results[].added_by: "api" (an API key), a console user's email or "console", "system" (entries Didit provisions), or "rule" (a transaction rule action).
\- results[].reference_session_id / reference_session_number / reference_session_type: set when the entry was taken from a verification session; reference_session_type is "kyc" or "kyb".
\- results[].reference_object_uuid + metadata.reference_type: the record the entry stands for. metadata.reference_type, when you set it, says whether reference_object_uuid is a "transaction", a "vendor_user" or a "vendor_business".
\- results[].metadata: may include document context (full_name, issuing_state, document_type, document_number), face image URLs, and, for faces from a document-capture selfie, face_image_source and reference_node_id.

Failure modes:
\- 400: reference_session_id is not a valid UUID, or limit/offset above 1000000.
\- 401: the API key has expired.
\- 403: missing x-api-key (a wrong, revoked or expired key gets 401) ({ "detail": "You do not have permission to perform this action." }), or a scoped key without workflows: read.
\- 404: no list with this UUID in this application, or it was deleted ({ "detail": "List not found." }).
\- 429: rate limited (see /integration/rate-limiting); back off and retry.

Side effects: none. This is a pure read.

For the full integration shape, see /integration/integration-prompt.`

\
Tempel ke Ambil entri dari satu daftar, diurutkan dari yang terbaru, dengan pencarian opsional. `search` mencocokkan sebagian nilai atau label entri tanpa memperhatikan huruf besar atau kecil; `reference_session_id` mempersempit hasil ke entri yang diambil dari satu sesi verifikasi. Pada daftar wajah, `metadata.face_image_source` menunjukkan dari wajah sesi mana setiap entri berasal (`liveness` jika tidak ada).Entri wajah dan dokumen menyertakan URL gambar di `metadata` yang kedaluwarsa tak lama setelah panggilan. Ambil ulang entri untuk mendapatkan URL yang baru, dan jangan menyimpannya. Kunci API tanpa **media: read** menerima `null` untuk URL tersebut. ## OpenAPI ````yaml id/openapi-25.json GET /v3/lists/{list_uuid}/entries/ openapi: 3.0.0 info: version: 3.0.0 title: Didit Verification API description: API Verifikasi Identitas. Lakukan autentikasi dengan header x-api-key. servers: - url: https://verification.didit.me security: [] tags: [] paths: /v3/lists/{list_uuid}/entries/: get: tags: - Lists summary: Mencantumkan entri daftar description: >- Mengembalikan entri saat ini dari satu daftar, yang terbaru terlebih dahulu. `search` mencocokkan sebagian dari `value` atau `display_label` suatu entri tanpa membedakan huruf besar/kecil, dan `reference_session_id` mempersempit hasil ke entri yang diambil dari satu sesi verifikasi seseorang. URL gambar dalam `metadata` adalah URL bertanda tangan berumur pendek yang diterbitkan kembali pada setiap pemanggilan; kunci API ber-scope tanpa `media: read` menerima `null` sebagai gantinya. Kunci API ber-scope memerlukan `workflows: read`. operationId: list_list_entries parameters: - name: list_uuid in: path required: true description: >- UUID daftar, seperti yang dikembalikan oleh Cantumkan daftar atau Buat daftar. schema: type: string format: uuid example: 11111111-2222-3333-4444-555555555555 - name: search in: query required: false description: >- Teks tidak peka huruf besar/kecil yang harus termuat dalam `value` atau `display_label` entri. schema: type: string - name: reference_session_id in: query required: false description: >- Hanya entri yang diambil dari sesi verifikasi individu ini, misalnya untuk melihat wajah mana saja miliknya yang sudah terdaftar. schema: type: string format: uuid - name: limit in: query required: false description: >- Ukuran halaman. Nilai default-nya 50. Nilai di atas 1000000 mengembalikan `400`; nol, nilai negatif, atau nilai non-numerik akan kembali ke 50. schema: type: integer default: 50 minimum: 1 maximum: 1000000 - name: offset in: query required: false description: >- Indeks berbasis nol dari item pertama yang dikembalikan. Sebaiknya ikuti `next`. Nilai di atas 1000000 mengembalikan `400`; nilai negatif atau non-numerik akan kembali ke 0. schema: type: integer maximum: 1000000 minimum: 0 default: 0 responses: '200': description: Satu halaman entri, yang terbaru lebih dulu. content: application/json: schema: type: object required: - count - next - previous - results properties: count: type: integer minimum: 0 description: Jumlah total entri yang cocok dengan filter. next: type: string format: uri nullable: true description: >- URL absolut halaman berikutnya, atau `null` di halaman terakhir. previous: type: string format: uri nullable: true description: >- URL absolut halaman sebelumnya, atau `null` di halaman pertama. results: type: array items: $ref: '#/components/schemas/ComplianceListEntry' examples: Entries: value: 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' '400': description: Parameter kueri tidak valid. content: application/json: examples: Invalid session id: value: reference_session_id: - Must be a valid UUID. Limit too large: value: - limit must not exceed 1000000. '401': description: >- Kunci API dengan cakupan terbatas telah kedaluwarsa. Kegagalan autentikasi lainnya mengembalikan `403`. content: application/json: examples: Expired API key: value: detail: This API key has expired. '403': description: >- Header `x-api-key` tidak ada (kunci yang salah, dicabut, atau kedaluwarsa menghasilkan `401`), atau kunci API dengan cakupan tertentu tidak memiliki `workflows: read` atau digunakan dari alamat IP di luar daftar izinnya. content: application/json: examples: Missing or invalid API key: value: detail: You do not have permission to perform this action. Scoped key without workflows access: value: detail: This API key has no read access to workflows. '404': description: >- Tidak ada daftar dengan UUID ini di aplikasi milik kunci API, atau daftar tersebut telah dihapus. content: application/json: examples: Not found: value: detail: List not found. '429': description: >- Batas baca bersama sebesar 600 permintaan per menit per kunci API telah terlampaui. Patuhi `Retry-After` sebelum mencoba lagi. content: application/json: examples: Rate limited: value: detail: >- GET request rate limit exceeded. You can make up to 600 requests per minute. security: - ApiKeyAuth: [] x-codeSamples: - lang: curl label: curl source: >- 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' - lang: python label: Python source: |- from didit import Didit # Reads DIDIT_API_KEY. client = Didit() for item in client.lists.entries.list( "11111111-2222-3333-4444-555555555555", ): print(item) - lang: javascript label: Node.js source: >- 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); } - lang: go label: Go source: "ctx := context.Background()\n// Reads DIDIT_API_KEY.\nclient := didit.NewClient()\n\niter := client.Lists.Entries.ListAutoPaging(ctx, \"11111111-2222-3333-4444-555555555555\", didit.ListsEntriesListParams{})\nfor iter.Next() {\n\tfmt.Printf(\"%+v\\n\", iter.Current())\n}\nif err := iter.Err(); err != nil {\n\tlog.Fatal(err)\n}" - lang: java label: Java source: >- 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); } - lang: php label: PHP source: >- lists->entries->list('11111111-2222-3333-4444-555555555555') as $item) { print_r($item->toArray()); } - lang: ruby label: Ruby source: >- 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 end - lang: csharp label: .NET source: >- using 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)); } components: schemas: ComplianceListEntry: type: object description: Satu nilai dalam sebuah daftar. required: - uuid - value - display_label - comment - added_by - reference_session_id - reference_session_number - reference_session_type - reference_object_uuid - metadata - created_at properties: uuid: type: string format: uuid description: >- Pengidentifikasi entri. Gunakan sebagai `entry_uuid` dalam operasi Hapus entri daftar. value: type: string description: >- Nilai yang terdaftar: nomor telepon dalam format E.164, alamat email, nomor dokumen, alamat IP atau rentang CIDR, sidik jari perangkat, alamat dompet, rekening bank, kode negara ISO 3166-1 alpha-3, `vendor_data`, string apa pun pada daftar `key`, atau UUID wajah yang disimpan pada daftar wajah. Nilai yang Anda kirim disimpan dalam huruf kecil, kecuali nomor telepon dan kode negara. Pencocokan tidak membedakan huruf besar dan kecil. display_label: type: string nullable: true maxLength: 512 description: >- Label yang mudah dibaca manusia. Didit mengisinya untuk entri yang diambil dari sesi (misalnya nama pemegang dan nomor dokumen) saat Anda tidak mengirimkannya. comment: type: string description: Catatan teks bebas. String kosong jika tidak diatur. added_by: type: string nullable: true description: >- Pihak yang menambahkan entri: `api` (kunci API), alamat email pengguna konsol atau `console`, `system` atau `migration` (entri yang dibuat Didit), atau `rule` (tindakan aturan transaksi atau aturan pemantauan). reference_session_id: type: string format: uuid nullable: true description: >- Sesi verifikasi tempat entri tersebut diambil. `null` jika entri ditambahkan berdasarkan nilai. reference_session_number: type: integer nullable: true description: >- Nomor sesi tersebut dalam cakupan aplikasi, seperti yang ditampilkan di konsol. reference_session_type: type: string nullable: true enum: - kyc - kyb - null description: >- `kyc` untuk sesi verifikasi perorangan, `kyb` untuk sesi verifikasi bisnis, `null` ketika tidak ada sesi. reference_object_uuid: type: string format: uuid nullable: true description: >- Rekaman yang diwakili oleh entri: rekaman wajah, dokumen, telepon, atau email yang dibaca dari sesi, wajah yang dibuat melalui Unggah wajah ke daftar, atau UUID yang Anda kirim (misalnya UUID transaksi atau `didit_internal_id` milik pengguna). metadata: type: object nullable: true additionalProperties: true description: >- Konteks tambahan. Berisi kunci yang ditetapkan Didit (tercantum di sini) yang digabungkan dengan `metadata` apa pun yang Anda kirimkan saat membuat entri, dikembalikan seperti yang disimpan. `null` jika tidak ada. properties: reference_image_url: type: string description: >- Entri wajah: URL bertanda tangan berumur pendek, diterbitkan kembali pada setiap panggilan; `null` untuk kunci API dengan cakupan terbatas tanpa `media: read`. Tidak ada jika tidak ada gambar milik entri tersebut. front_image_url: type: string description: >- Entri dokumen yang memuat gambar depan dokumen: URL bertanda tangan berumur pendek, diterbitkan ulang pada setiap panggilan; `null` untuk kunci API dengan cakupan tanpa `media: read`. full_name: type: string description: 'Entri dokumen yang diambil dari sesi: nama lengkap pemegang.' issuing_state: type: string description: >- Entri dokumen yang diambil dari sesi: negara penerbit ISO 3166-1 alpha-3. document_type: type: string description: >- Entri dokumen yang diambil dari sesi: kode jenis dokumen, misalnya `P`, `ID` atau `DL`. region: type: string description: >- Entri dokumen yang diambil dari sesi: negara bagian atau provinsi penerbit dokumen yang diterbitkan secara regional, kosong jika tidak berlaku. Tidak diatur oleh penambahan item sesi ke daftar blokir. document_number: type: string description: 'Entri dokumen yang diambil dari sesi: nomor dokumen.' face_image_source: type: string enum: - front_image_camera_front - back_image_camera_front description: >- Entri wajah yang diambil dari swafoto pengambilan dokumen: swafoto yang mana. Tidak ada untuk wajah dari liveness. reference_node_id: type: string nullable: true description: >- Entri wajah yang diambil dari swafoto dari pengambilan dokumen: node verifikasi identitas asal swafoto tersebut. fingerprint_tier: type: string nullable: true enum: - persistent_id - composite_hash - legacy_fp - unknown - null description: >- Entri sidik jari perangkat yang diambil dari sesi: bagaimana sidik jari tersebut diturunkan. `persistent_id` mengidentifikasi satu perangkat; `composite_hash` dan `legacy_fp` dapat digunakan bersama oleh perangkat dari model yang sama. sandbox: type: boolean description: >- `true` pada entri wajah yang diunggah dalam aplikasi sandbox; entri tersebut tidak mencocokkan apa pun. reference_type: type: string enum: - transaction - vendor_user - vendor_business description: >- Ditetapkan oleh Anda: apa yang ditunjuk oleh `reference_object_uuid`, sehingga konsol menautkan kembali ke sana. reference_id: type: string description: 'Ditetapkan oleh Anda: pengidentifikasi rekaman sumber.' created_at: type: string format: date-time description: Waktu ketika entri ditambahkan. securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- Kunci API aplikasi Anda, dari Developers -> API keys di Business Console. Kunci utama memiliki akses penuh. Kunci bernama dapat diberi cakupan: none, read, atau write per sumber daya, dibatasi pada beberapa alur kerja atau pada sesi yang disetujui, pada daftar alamat IP, dan pada tanggal kedaluwarsa. 401 berarti kuncinya salah, dicabut, atau kedaluwarsa; 403 berarti tidak ada kunci yang dikirimkan, kunci tidak memiliki akses ke sumber daya atau tindakan ini, atau permintaan datang dari alamat di luar daftar IP-nya; 404 pada rute sesi berarti sesi berada di luar alur kerja atau status kunci tersebut. Kunci tanpa akses media menerima URL gambar, video, dan PDF sebagai null, dan kunci tanpa izin tulis sesi menerima tautan sesi dan token sebagai null. Lihat https://docs.didit.me/console/api-keys. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.