> ## 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 - Travel Rule 검토
> 검토 대기 중인 스크린샷 지갑 소유권 증명을 오래된 순으로 조회합니다. 업로드된 이미지, 지갑, 연결된 거래, 증명 이력을 Didit에서 확인할 수 있습니다.
지갑 증명 목록 조회 API 프롬프트
프롬프트를 클립보드에 복사
\`List the screenshot wallet-ownership proofs my end users uploaded from the wallet-ownership widget, so my compliance team can review them.
Endpoint:
GET [https://verification.didit.me/v3/travel-rule/wallet-proofs/](https://verification.didit.me/v3/travel-rule/wallet-proofs/)
Authentication:
Use the x-api-key header with my Didit API key.
Query parameters:
* status - PENDING (default, the proofs still to decide), VERIFIED, REJECTED or EXPIRED.
* limit, offset - pagination.
What to read from each result:
* proof\_id - pass it to POST /v3/travel-rule/wallet-proofs/{proof_uuid}/decision/ to approve or reject.
* screenshot\_url - time-limited link to the uploaded image; list again for a fresh link.
* wallet\_address, chain (canonical, e.g. ETH, BTC, SOL, TRX), holder\_name, is\_ownership\_verified.
* transaction\_id - the transaction the widget session was minted for, null when none.
* attempts, failure\_reason, method\_chosen\_at, decided\_at, decided\_by, review\_note.
Behavior:
* Oldest first, so the proof that has waited longest comes first.
* Only uploaded screenshots appear. A proof on a wallet I deleted from my address book never appears: Didit closes it as OWNERSHIP\_CHANGED.
Failure modes:
* 400 - unknown status.
* 401 - missing or malformed x-api-key.
Full guide: /transaction-monitoring/wallet-ownership-widget#what-it-proves.\`
붙여넣을 곳
## OpenAPI
````yaml ko/openapi-25.json GET /v3/travel-rule/wallet-proofs/
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/travel-rule/wallet-proofs/:
get:
tags:
- Travel Rule
summary: 검토할 스크린샷 지갑 증명 목록 조회
description: >-
스크린샷 지갑 소유권 증명을 위한 귀하의 검토 대기열입니다. 스크린샷은 Didit이 직접 확인할 수 없는 유일한 증명 방식입니다.
최종 사용자가 위젯에서 업로드하면 POST
/v3/travel-rule/wallet-proofs/{proof_uuid}/decision/을 통해 승인하거나 거부할 때까지
PENDING 상태로 대기합니다. 가장 오래된 항목부터 정렬되므로 대기열은 가장 오래 대기한 증명부터 처리됩니다. 업로드된
스크린샷만 표시되며, 최종 사용자가 아직 파일을 업로드하지 않은 증명이나 주소록에서 삭제한 지갑의 증명(Didit은 이를
OWNERSHIP_CHANGED로 종결함)은 표시되지 않습니다.
operationId: listTravelRuleWalletProofs
parameters:
- name: status
in: query
description: 조회할 증명 목록입니다. 기본값은 아직 결정되지 않은 항목인 PENDING입니다.
schema:
type: string
enum:
- PENDING
- VERIFIED
- REJECTED
- EXPIRED
default: PENDING
- name: limit
in: query
schema:
type: integer
default: 50
minimum: 1
- name: offset
in: query
schema:
type: integer
default: 0
minimum: 0
responses:
'200':
description: 페이지네이션된 스크린샷 증명 목록입니다. 개수는 100까지 정확하며, 100을 초과하면 100으로 제한됩니다.
content:
application/json:
schema:
type: object
properties:
count:
type: integer
next:
type: string
nullable: true
previous:
type: string
nullable: true
results:
type: array
items:
$ref: '#/components/schemas/TravelRuleWalletProofReview'
'400':
description: 알 수 없는 상태입니다.
'401':
description: x-api-key가 누락되었거나 유효하지 않습니다.
'403':
description: 호출자에게 거래 권한이 없습니다.
security:
- ApiKeyAuth: []
x-codeSamples:
- lang: curl
label: curl
source: >-
curl
https://verification.didit.me/v3/travel-rule/wallet-proofs/?status=PENDING
\
-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.travel_rule.wallet_proofs.list():
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.travelRule.walletProofs.list()) {
console.log(item);
}
- lang: java
label: Java
source: |-
import me.didit.Didit;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
for (var item : client.travelRule().walletProofs().list()) {
System.out.println(item);
}
- lang: php
label: PHP
source: |-
travelRule->walletProofs->list() as $item) {
print_r($item->toArray());
}
- lang: ruby
label: Ruby
source: |-
require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
didit.travel_rule.wallet_proofs.list.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.TravelRule.WalletProofs.ListAsync())
{
Console.WriteLine(JsonSerializer.Serialize(item));
}
components:
schemas:
TravelRuleWalletProofReview:
type: object
properties:
proof_id:
type: string
format: uuid
method:
type: string
enum:
- SCREENSHOT
status:
type: string
enum:
- PENDING
- VERIFIED
- REJECTED
- EXPIRED
wallet_address:
type: string
chain:
type: string
description: '표준 체인 식별자입니다(예: ETH, BTC, SOL, TRX).'
holder_name:
type: string
is_ownership_verified:
type: boolean
description: 이 증명 또는 다른 증명을 통해 주소록 항목의 소유권이 확인되었는지 여부입니다.
transaction_id:
type: string
format: uuid
nullable: true
description: >-
위젯 세션이 발급된 Travel Rule 전송에 해당하는 거래입니다. transaction_id 없이 발급된 세션의 경우
null입니다.
file_name:
type: string
nullable: true
content_type:
type: string
nullable: true
screenshot_url:
type: string
nullable: true
description: 업로드된 스크린샷에 대한 시간 제한 링크입니다. 최신 링크를 가져오려면 대기열을 다시 나열하십시오.
attempts:
type: integer
description: 최종 사용자가 이 증명을 위해 업로드한 파일 수입니다.
failure_reason:
allOf:
- $ref: '#/components/schemas/TravelRuleWalletProofFailureReason'
description: >-
거부 후에는 REVIEW_REJECTED, 결정 전에 지갑 소유자가 변경되었거나 지갑이 삭제된 경우에는
OWNERSHIP_CHANGED입니다. 그 외의 경우에는 비어 있습니다.
method_chosen_at:
type: string
format: date-time
nullable: true
description: 최종 사용자가 스크린샷 방식을 선택한 시점입니다.
decided_at:
type: string
format: date-time
nullable: true
decided_by:
type: string
description: >-
증명을 마감한 주체: 콘솔 검토자의 경우 review:, API 키 결정의 경우
review, Didit이 자동으로 마감한 경우 widget 또는 sweeper입니다. PENDING 상태인 동안에는 비어
있습니다.
review_note:
type: string
description: 결정과 함께 전송된 메모입니다. 없는 경우 비어 있습니다.
created_at:
type: string
format: date-time
TravelRuleWalletProofFailureReason:
type: string
enum:
- ''
- SIGNATURE_INVALID
- SIGNATURE_UNSUPPORTED_SCHEME
- DEPOSIT_NOT_FOUND
- DEPOSIT_UNCONFIRMED
- DEPOSIT_LOOKUP_FAILED
- DEPOSIT_MISMATCH
- DEPOSIT_STALE
- TXID_REUSED
- CHAIN_UNSUPPORTED
- WINDOW_EXPIRED
- OWNERSHIP_CHANGED
- METHOD_SWITCHED
- REVIEW_REJECTED
- ABANDONED
description: >-
지갑 소유권 증명 또는 마지막 시도가 VERIFIED에 도달하지 못한 이유입니다. 실패한 항목이 없으면 비어 있습니다.
PENDING 증명에도 포함될 수 있습니다. 즉 마지막 시도가 실패했으며 최종 사용자가 다시 시도할 수 있습니다.
DEPOSIT_MISMATCH, DEPOSIT_STALE, TXID_REUSED 및 REVIEW_REJECTED는 증명을
REJECTED 상태로 종료합니다. SIGNATURE_INVALID: 서명이 지갑 및 챌린지와 일치하지 않습니다.
SIGNATURE_UNSUPPORTED_SCHEME: 지갑이 Didit에서 검증하지 않는 형식으로 서명했습니다.
DEPOSIT_NOT_FOUND, DEPOSIT_UNCONFIRMED, DEPOSIT_LOOKUP_FAILED: 테스트 입금을
읽을 수 없거나 아직 확인되지 않았습니다. Didit은 테스트 기간이 종료될 때까지 계속 확인합니다.
DEPOSIT_MISMATCH: 트랜잭션이 지갑에서 입금 주소로 예상 금액을 전송하지 않습니다. DEPOSIT_STALE:
트랜잭션이 챌린지보다 이전 시점의 것입니다. TXID_REUSED: 트랜잭션이 이미 다른 지갑을 증명했습니다.
CHAIN_UNSUPPORTED: 이 체인에서는 해당 방식을 사용할 수 없습니다. WINDOW_EXPIRED: 테스트 기간이
만료되었습니다. OWNERSHIP_CHANGED: 위젯 세션이 생성된 후 지갑 소유자가 변경되었거나 주소록에서 지갑이
삭제되었습니다. METHOD_SWITCHED: 최종 사용자가 이 방식을 완료하기 전에 다른 방식을 선택했습니다.
REVIEW_REJECTED: 검토자가 스크린샷을 거부했습니다. ABANDONED: 최종 사용자가 완료하기 전에 위젯 세션이
만료되었습니다.
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.