> ## 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.
# Elenco prove di wallet da rivedere - API Travel Rule
> Elenca in Didit le prove di proprietà wallet da screenshot in attesa di revisione, dalla più vecchia: immagine, transazione e storico.
Prompt dell'API per elencare le prove del wallet
Copia il prompt negli appunti
\`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.\`
Incolla in
## OpenAPI
````yaml it/openapi-25.json GET /v3/travel-rule/wallet-proofs/
openapi: 3.0.0
info:
version: 3.0.0
title: Didit Verification API
description: API di verifica dell'identità. Autenticati con l'intestazione x-api-key.
servers:
- url: https://verification.didit.me
security: []
tags: []
paths:
/v3/travel-rule/wallet-proofs/:
get:
tags:
- Travel Rule
summary: Elenca prove del wallet tramite screenshot da revisionare
description: >-
La tua coda di revisione per le prove di proprietà del wallet tramite
screenshot. Lo screenshot è l'unica prova che Didit non può verificare
automaticamente: una volta che l'utente finale lo carica dal widget,
rimane in stato PENDING fino a quando non lo approvi o lo rifiuti con
POST /v3/travel-rule/wallet-proofs/{proof_uuid}/decision/. Prima le
prove più vecchie, così la coda viene gestita a partire dalla prova in
attesa da più tempo. Vengono mostrati solo gli screenshot caricati, mai
una prova per cui l'utente finale non ha ancora caricato un file, e mai
una su un wallet eliminato dalla tua rubrica (Didit le chiude con
OWNERSHIP_CHANGED).
operationId: listTravelRuleWalletProofs
parameters:
- name: status
in: query
description: >-
Quali prove elencare. Il valore predefinito è PENDING, ovvero quelle
ancora da decidere.
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: >-
Prove tramite screenshot impaginate. Il conteggio è esatto fino a
100 e bloccato a 100 oltre tale soglia.
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: Stato sconosciuto.
'401':
description: x-api-key mancante o non valida.
'403':
description: Il chiamante non dispone dell'autorizzazione per le transazioni.
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: >-
Identificatore canonico della rete blockchain, ad es. ETH, BTC, SOL,
TRX.
holder_name:
type: string
is_ownership_verified:
type: boolean
description: >-
Indica se la voce della rubrica ha la titolarità verificata, tramite
questa prova o un'altra.
transaction_id:
type: string
format: uuid
nullable: true
description: >-
La transazione per il cui trasferimento Travel Rule è stata generata
la sessione del widget. Null per una sessione generata senza
transaction_id.
file_name:
type: string
nullable: true
content_type:
type: string
nullable: true
screenshot_url:
type: string
nullable: true
description: >-
Link a tempo allo screenshot caricato. Elenca nuovamente la coda per
ottenere un link aggiornato.
attempts:
type: integer
description: Quanti file l'utente finale ha caricato per questa prova.
failure_reason:
allOf:
- $ref: '#/components/schemas/TravelRuleWalletProofFailureReason'
description: >-
REVIEW_REJECTED dopo un rifiuto, OWNERSHIP_CHANGED quando il wallet
ha cambiato titolare o è stato eliminato prima di una decisione.
Vuoto altrimenti.
method_chosen_at:
type: string
format: date-time
nullable: true
description: >-
Data e ora in cui l'utente finale ha scelto il metodo dello
screenshot.
decided_at:
type: string
format: date-time
nullable: true
decided_by:
type: string
description: >-
Chi ha chiuso la prova: review: per un
revisore della console, review per una decisione tramite chiave API,
widget o sweeper quando Didit l'ha chiusa automaticamente. Vuoto
finché è PENDING.
review_note:
type: string
description: La nota inviata con la decisione. Vuota se assente.
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: >-
Il motivo per cui una prova di titolarità del wallet, o il suo ultimo
tentativo, non ha raggiunto lo stato VERIFIED. Vuoto se non si è
verificato alcun errore. Una prova PENDING può contenerne uno: l'ultimo
tentativo è fallito e l'utente finale può riprovare. DEPOSIT_MISMATCH,
DEPOSIT_STALE, TXID_REUSED e REVIEW_REJECTED chiudono la prova come
REJECTED. SIGNATURE_INVALID: la firma non corrisponde al wallet e alla
challenge. SIGNATURE_UNSUPPORTED_SCHEME: il wallet ha firmato in un
formato non verificato da Didit. DEPOSIT_NOT_FOUND, DEPOSIT_UNCONFIRMED,
DEPOSIT_LOOKUP_FAILED: il deposito di prova non è leggibile o non è
ancora confermato; Didit continua a verificarlo fino alla chiusura della
finestra di prova. DEPOSIT_MISMATCH: la transazione non invia l'importo
previsto dal wallet all'indirizzo di deposito. DEPOSIT_STALE: la
transazione è antecedente alla challenge. TXID_REUSED: la transazione ha
già dimostrato la titolarità di un altro wallet. CHAIN_UNSUPPORTED: il
metodo non è disponibile su questa blockchain. WINDOW_EXPIRED: la
finestra di prova si è chiusa. OWNERSHIP_CHANGED: il titolare del wallet
è cambiato, oppure il wallet è stato eliminato dalla tua rubrica, dopo
la generazione della sessione del widget. METHOD_SWITCHED: l'utente
finale ha scelto un altro metodo prima di completare questo.
REVIEW_REJECTED: il tuo revisore ha rifiutato lo screenshot. ABANDONED:
la sessione del widget è scaduta prima che l'utente finale terminasse.
securitySchemes:
ApiKeyAuth:
type: apiKey
in: header
name: x-api-key
description: >-
La chiave API della tua applicazione, da Developers -> API keys nella
Business Console. La chiave primaria ha accesso completo. Una chiave con
nome può avere un ambito definito: nessuno, lettura o scrittura per
risorsa, limitata ad alcuni workflow o a sessioni approvate, a un elenco
di indirizzi IP e a una data di scadenza. 401 indica che la chiave è
errata, revocata o scaduta; 403 indica che non è stata inviata alcuna
chiave, che la chiave non ha accesso a questa risorsa o azione, oppure
che la richiesta proviene da un indirizzo non incluso nel suo elenco IP;
404 su una route di sessione indica che la sessione non rientra nei
workflow o negli stati previsti dalla chiave. Una chiave senza accesso
ai media riceve gli URL di immagini, video e PDF come null, e una chiave
senza permessi di scrittura sulle sessioni riceve link e token di
sessione come null. Consulta https://docs.didit.me/console/api-keys.
````
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.