> ## 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.
# List Screenshot Wallet Proofs API - Travel Rule Review
> List the screenshot wallet-ownership proofs waiting for your review, oldest first, with the uploaded image, wallet, linked transaction and proof history.
List Wallet Proofs API Prompt
Copy prompt to clipboard
\`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.\`
Paste into
## OpenAPI
````yaml GET /v3/travel-rule/wallet-proofs/
openapi: 3.0.0
info:
version: 3.0.0
title: Didit Verification API
description: Identity verification API. Authenticate with x-api-key header.
servers:
- url: https://verification.didit.me
security: []
tags: []
paths:
/v3/travel-rule/wallet-proofs/:
get:
tags:
- Travel Rule
summary: List screenshot wallet proofs to review
description: >-
Your review queue for screenshot wallet-ownership proofs. A screenshot
is the one proof Didit cannot check itself: once the end user uploads it
from the widget it waits PENDING until you approve or reject it with
POST /v3/travel-rule/wallet-proofs/{proof_uuid}/decision/. Oldest first,
so the queue is worked from the proof that has waited longest. Only
uploaded screenshots appear, never a proof whose end user has not
uploaded a file yet, and never one on a wallet you deleted from your
address book (Didit closes those as OWNERSHIP_CHANGED).
operationId: listTravelRuleWalletProofs
parameters:
- name: status
in: query
description: Which proofs to list. Defaults to PENDING, the ones still to decide.
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: >-
Paginated screenshot proofs. count is exact up to 100 and capped at
100 above it.
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: Unknown status.
'401':
description: Missing or invalid x-api-key.
'403':
description: The caller lacks the transactions permission.
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'
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: Canonical chain identifier, e.g. ETH, BTC, SOL, TRX.
holder_name:
type: string
is_ownership_verified:
type: boolean
description: >-
Whether the address book entry is ownership-verified, by this proof
or another one.
transaction_id:
type: string
format: uuid
nullable: true
description: >-
The transaction whose Travel Rule transfer the widget session was
minted for. Null for a session minted without a transaction_id.
file_name:
type: string
nullable: true
content_type:
type: string
nullable: true
screenshot_url:
type: string
nullable: true
description: >-
Time-limited link to the uploaded screenshot. List the queue again
for a fresh link.
attempts:
type: integer
description: How many files the end user uploaded for this proof.
failure_reason:
allOf:
- $ref: '#/components/schemas/TravelRuleWalletProofFailureReason'
description: >-
REVIEW_REJECTED after a rejection, OWNERSHIP_CHANGED when the wallet
changed holder or was deleted before a decision. Empty otherwise.
method_chosen_at:
type: string
format: date-time
nullable: true
description: When the end user picked the screenshot method.
decided_at:
type: string
format: date-time
nullable: true
decided_by:
type: string
description: >-
Who closed the proof: review: for a console
reviewer, review for an API-key decision, widget or sweeper when
Didit closed it automatically. Empty while PENDING.
review_note:
type: string
description: The note sent with the decision. Empty when none.
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: >-
Why a wallet-ownership proof, or its last attempt, fell short of
VERIFIED. Empty when nothing failed. A PENDING proof can carry one: the
last attempt failed and the end user can try again. DEPOSIT_MISMATCH,
DEPOSIT_STALE, TXID_REUSED and REVIEW_REJECTED close the proof as
REJECTED. SIGNATURE_INVALID: the signature does not match the wallet and
challenge. SIGNATURE_UNSUPPORTED_SCHEME: the wallet signed in a format
Didit does not verify. DEPOSIT_NOT_FOUND, DEPOSIT_UNCONFIRMED,
DEPOSIT_LOOKUP_FAILED: the test deposit is not readable or not confirmed
yet; Didit keeps checking it until the test window closes.
DEPOSIT_MISMATCH: the transaction does not send the expected amount from
the wallet to the deposit address. DEPOSIT_STALE: the transaction
predates the challenge. TXID_REUSED: the transaction already proved
another wallet. CHAIN_UNSUPPORTED: the method is not available on this
chain. WINDOW_EXPIRED: the test window closed. OWNERSHIP_CHANGED: the
wallet's holder changed, or the wallet was deleted from your address
book, after the widget session was minted. METHOD_SWITCHED: the end user
picked another method before finishing this one. REVIEW_REJECTED: your
reviewer rejected the screenshot. ABANDONED: the widget session lapsed
before the end user finished.
securitySchemes:
ApiKeyAuth:
type: apiKey
in: header
name: x-api-key
description: >-
Your application's API key, from Developers -> API keys in the Business
Console. The primary key has full access. A named key can be scoped:
none, read or write per resource, limited to some workflows or to
approved sessions, to a list of IP addresses, and to an expiry date. 401
means the key is missing, wrong, revoked or expired; 403 means the key
has no access to this resource or action, or the request came from an
address outside its IP list; 404 on a session route means the session is
outside the key's workflows or statuses. A key without media access
receives image, video and PDF URLs as null, and a key without sessions
write receives session links and tokens as null. See
https://docs.didit.me/console/api-keys.
````
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.