> ## 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: 차단 목록 및 허용 목록 항목 조회 > Didit 차단 목록, 허용 목록, 커스텀 목록의 항목을 검색 필터와 함께 페이지 단위로 조회합니다. GET /v3/lists/{list_uuid}/entries/. 호출당 과금. List Entries API 프롬프트 프롬프트를 클립보드에 복사 \

\`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.`

\
붙여넣을 곳 한 목록의 항목을 최신순으로 조회합니다. 선택적으로 검색할 수 있습니다. `search`는 항목의 값 또는 라벨 일부와 대소문자를 구분하지 않고 일치합니다. `reference_session_id`는 결과를 특정 인증 세션에서 가져온 항목으로 좁힙니다. 얼굴 목록에서는 `metadata.face_image_source`로 각 항목이 해당 세션의 어떤 얼굴인지 알 수 있습니다(값이 없으면 `liveness`).얼굴 및 문서 항목의 `metadata`에 있는 이미지 URL은 호출 후 곧 만료됩니다. URL을 저장하지 말고, 새 URL을 받으려면 항목을 다시 조회하세요. **media: read** 권한이 없는 API 키는 해당 URL 대신 `null`을 받습니다. ## OpenAPI ````yaml ko/openapi-25.json GET /v3/lists/{list_uuid}/entries/ openapi: 3.0.0 info: version: 3.0.0 title: Didit Verification API description: 신분증 인증 API입니다. x-api-key 헤더로 인증합니다. servers: - url: https://verification.didit.me security: [] tags: [] paths: /v3/lists/{list_uuid}/entries/: get: tags: - Lists summary: 목록 항목 조회 description: >- 단일 목록의 현재 항목을 최신순으로 반환합니다. `search`는 대소문자를 구분하지 않고 항목의 `value` 또는 `display_label` 일부와 일치하는 항목을 검색하며, `reference_session_id`는 단일 개인 인증 세션에서 가져온 항목으로 결과를 좁힙니다. `metadata`의 이미지 URL은 호출할 때마다 새로 발급되는 유효 기간이 짧은 서명된 URL이며, `media: read` 권한이 없는 범위 지정 API 키는 해당 위치에 `null`을 받습니다. 범위 지정 API 키에는 `workflows: read` 권한이 필요합니다. operationId: list_list_entries parameters: - name: list_uuid in: path required: true description: 목록 조회(List lists) 또는 목록 생성(Create a list)에서 반환된 목록의 UUID입니다. schema: type: string format: uuid example: 11111111-2222-3333-4444-555555555555 - name: search in: query required: false description: 항목의 `value` 또는 `display_label`에 포함되어야 하는 대소문자를 구분하지 않는 텍스트. schema: type: string - name: reference_session_id in: query required: false description: '이 개인 인증 세션에서 가져온 항목만 해당합니다(예: 세션의 얼굴 중 어떤 얼굴이 이미 등록되어 있는지 확인하려는 경우).' schema: type: string format: uuid - name: limit in: query required: false description: >- 페이지 크기입니다. 기본값은 50입니다. 1000000을 초과하는 값은 `400`을 반환하며, 0, 음수 또는 숫자가 아닌 값은 50으로 대체됩니다. schema: type: integer default: 50 minimum: 1 maximum: 1000000 - name: offset in: query required: false description: >- 반환할 첫 번째 항목의 0부터 시작하는 인덱스입니다. `next`를 따르는 것이 좋습니다. 1000000을 초과하는 값은 `400`을 반환하며, 음수이거나 숫자가 아닌 값은 0으로 대체됩니다. schema: type: integer maximum: 1000000 minimum: 0 default: 0 responses: '200': description: 최신순으로 정렬된 엔트리 페이지입니다. content: application/json: schema: type: object required: - count - next - previous - results properties: count: type: integer minimum: 0 description: 필터와 일치하는 항목의 총 개수입니다. next: type: string format: uri nullable: true description: 다음 페이지의 절대 URL이며, 마지막 페이지에서는 `null`입니다. previous: type: string format: uri nullable: true description: 이전 페이지의 절대 URL이며, 첫 번째 페이지에서는 `null`입니다. 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: 쿼리 파라미터가 유효하지 않습니다. 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: 스코프가 지정된 API 키가 만료되었습니다. 기타 인증 실패 시에는 `403`이 반환됩니다. content: application/json: examples: Expired API key: value: detail: This API key has expired. '403': description: >- `x-api-key` 헤더가 누락되었거나(잘못되었거나 해지되었거나 만료된 키는 `401` 반환), 범위가 지정된 API 키에 `workflows: read` 권한이 없거나 허용 목록 외부의 IP 주소에서 사용되었습니다. 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: API 키의 애플리케이션에 이 UUID를 가진 목록이 존재하지 않거나 삭제되었습니다. content: application/json: examples: Not found: value: detail: List not found. '429': description: >- API 키당 분당 600개의 요청을 처리하는 공유 읽기 속도 제한을 초과했습니다. 다시 시도하기 전에 `Retry-After`를 준수하십시오. 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: 목록 내의 값 1개입니다. 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: 항목 식별자. 목록 항목 삭제에서 `entry_uuid`로 사용합니다. value: type: string description: >- 목록에 등록된 값: E.164 형식의 전화번호, 이메일 주소, 문서 번호, IP 주소 또는 CIDR 범위, 기기 지문, 지갑 주소, 은행 계좌, ISO 3166-1 alpha-3 국가 코드, `vendor_data`, `key` 목록의 모든 문자열, 또는 얼굴 목록에 저장된 얼굴의 UUID입니다. 전송하는 값은 전화번호와 국가 코드를 제외하고 소문자로 저장됩니다. 일치 여부 확인 시 대소문자를 구분하지 않습니다. display_label: type: string nullable: true maxLength: 512 description: >- 사람이 읽기 쉬운 라벨입니다. 아무것도 전송하지 않으면 Didit이 세션에서 가져온 항목(예: 소지자의 성명 및 문서 번호)으로 채웁니다. comment: type: string description: 자유 형식 메모입니다. 설정되지 않은 경우 빈 문자열입니다. added_by: type: string nullable: true description: >- 항목을 추가한 주체: `api`(API 키), 콘솔 사용자의 이메일 주소 또는 `console`, `system` 또는 `migration`(Didit이 생성한 항목), 또는 `rule`(거래 규칙 또는 모니터링 규칙의 작업). reference_session_id: type: string format: uuid nullable: true description: 해당 항목을 가져온 인증 세션입니다. 항목이 값으로 직접 추가된 경우 `null`입니다. reference_session_number: type: integer nullable: true description: 콘솔에 표시되는 해당 세션의 애플리케이션별 번호입니다. reference_session_type: type: string nullable: true enum: - kyc - kyb - null description: 개인 인증 세션인 경우 `kyc`, 기업 확인 세션인 경우 `kyb`, 세션이 없는 경우 `null`입니다. reference_object_uuid: type: string format: uuid nullable: true description: >- 항목이 나타내는 레코드입니다. 세션에서 읽은 얼굴, 문서, 전화번호 또는 이메일 레코드, 목록에 얼굴 업로드를 통해 생성된 얼굴, 또는 전송한 UUID(예: 거래 UUID 또는 사용자의 `didit_internal_id`)입니다. metadata: type: object nullable: true additionalProperties: true description: >- 추가 컨텍스트입니다. 항목 생성 시 전송한 `metadata`와 병합된 Didit이 설정한 키(여기에 나열됨)가 포함되며, 저장된 그대로 반환됩니다. 없는 경우 `null`입니다. properties: reference_image_url: type: string description: >- 얼굴 항목: 호출마다 새로 발급되는 단기 서명된 URL입니다. `media: read` 권한이 없는 범위 지정 API 키의 경우 `null`입니다. 해당 항목에 이미지가 없으면 생략됩니다. front_image_url: type: string description: >- 문서 앞면 이미지를 포함하는 문서 항목: 호출할 때마다 다시 발급되는 수명이 짧은 서명된 URL입니다. `media: read` 권한이 없는 범위가 지정된 API 키의 경우 `null`입니다. full_name: type: string description: '세션에서 가져온 문서 항목: 소지자의 성명입니다.' issuing_state: type: string description: '세션에서 가져온 문서 항목: ISO 3166-1 alpha-3 발급 국가입니다.' document_type: type: string description: '세션에서 가져온 문서 항목: 문서 유형 코드(예: `P`, `ID`, `DL`)입니다.' region: type: string description: >- 세션에서 가져온 문서 항목: 지역에서 발급된 문서의 발급 주 또는 도이며, 해당하지 않는 경우 비어 있습니다. 세션 항목을 차단 목록에 추가해도 설정되지 않습니다. document_number: type: string description: '세션에서 가져온 문서 항목: 문서 번호입니다.' face_image_source: type: string enum: - front_image_camera_front - back_image_camera_front description: '문서 캡처 셀피에서 가져온 얼굴 항목: 셀피 구분입니다. 라이브니스 얼굴인 경우 없습니다.' reference_node_id: type: string nullable: true description: '문서 캡처 셀피에서 가져온 얼굴 항목: 셀피가 생성된 신분증 인증 노드입니다.' fingerprint_tier: type: string nullable: true enum: - persistent_id - composite_hash - legacy_fp - unknown - null description: >- 세션에서 수집된 기기 핑거프린트 항목(핑거프린트가 파생된 방식)입니다. `persistent_id`는 단일 기기를 식별하며, `composite_hash` 및 `legacy_fp`는 동일한 모델의 기기 간에 공유될 수 있습니다. sandbox: type: boolean description: 샌드박스 애플리케이션에 업로드된 얼굴 항목인 경우 `true`입니다. 이러한 항목은 어떤 것과도 일치하지 않습니다. reference_type: type: string enum: - transaction - vendor_user - vendor_business description: >- 사용자가 직접 설정: 콘솔에서 다시 연결할 수 있도록 `reference_object_uuid`가 가리키는 대상입니다. reference_id: type: string description: '사용자가 직접 설정: 소스 레코드의 식별자입니다.' created_at: type: string format: date-time description: 항목이 추가된 시점입니다. securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- Business Console의 Developers -> API keys에서 발급받은 귀하 애플리케이션의 API 키입니다. 기본 키는 전체 접근 권한을 갖습니다. 이름이 지정된 키는 리소스별 none, read, write 범위로 권한을 제한할 수 있으며 특정 워크플로나 승인된 세션, IP 주소 목록, 만료일 등으로 제한할 수도 있습니다. 401은 키가 잘못되었거나 폐기되었거나 만료되었음을 의미합니다. 403은 키가 전송되지 않았거나, 키에 해당 리소스나 작업에 대한 접근 권한이 없거나, 요청이 허용된 IP 목록 외부 주소에서 발생했음을 의미합니다. 세션 경로에서의 404는 해당 세션이 키의 허용 워크플로 또는 상태 범위를 벗어났음을 의미합니다. 미디어 접근 권한이 없는 키는 이미지, 비디오, PDF URL을 null로 수신하며, 세션 write 권한이 없는 키는 세션 링크와 token을 null로 수신합니다. https://docs.didit.me/console/api-keys 를 참고하십시오. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.