> ## 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 Management APIで、レビュー待ちのスクリーンショットによるウォレット所有証明を古い順に一覧取得します。アップロード画像、ウォレット、関連する取引、証明履歴を含みます。
ウォレット証明一覧取得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 ja/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: ページ分割されたスクリーンショット証跡の一覧。countは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: >-
ウィジェットセッションの発行対象となったトラベルルール送金の取引。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: >-
お客様のアプリケーションのAPIキーです。Business ConsoleのDevelopers -> API
keysで取得できます。プライマリキーはフルアクセス権を持ちます。名前付きキーにはスコープを設定できます。リソースごとのアクセス権（なし、読み取り、書き込み）、一部のワークフローまたは承認済みセッションへの限定、IPアドレスのリストへの限定、有効期限の設定です。401は、キーが誤っている、失効している、または期限切れであることを意味します。403は、キーが送信されていない、キーにこのリソースやアクションへのアクセス権がない、またはIPリスト外のアドレスからリクエストが送信されたことを意味します。セッションのルートでの404は、セッションがキーのワークフローまたはステータスの対象外であることを意味します。メディアへのアクセス権がないキーでは、画像、動画、PDFのURLがnullで返されます。セッションの書き込み権限がないキーでは、セッションのリンクとトークンがnullで返されます。詳細は次を参照してください:
https://docs.didit.me/console/api-keys
````
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.