> ## 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.
# Listar comprovantes de carteira por captura de tela
> A API do Didit lista comprovantes de carteira por captura de tela aguardando revisão, do mais antigo, com imagem, carteira, transação e histórico.
Prompt da API para listar provas de carteira
Copiar o prompt para a área de transferência
\`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.\`
Colar em
## OpenAPI
````yaml pt-br/openapi-25.json GET /v3/travel-rule/wallet-proofs/
openapi: 3.0.0
info:
version: 3.0.0
title: Didit Verification API
description: API de verificação de identidade. Autentique-se com o cabeçalho x-api-key.
servers:
- url: https://verification.didit.me
security: []
tags: []
paths:
/v3/travel-rule/wallet-proofs/:
get:
tags:
- Travel Rule
summary: Listar comprovantes de carteira por captura de tela para revisão
description: >-
Sua fila de revisão das provas de propriedade de carteira por captura de
tela. Uma captura de tela é a única prova que a Didit não consegue
verificar sozinha: depois que o usuário final a envia pelo widget, ela
fica PENDING até que você a aprove ou rejeite com POST
/v3/travel-rule/wallet-proofs/{proof_uuid}/decision/. As mais antigas
aparecem primeiro, para que a fila seja trabalhada a partir da prova que
espera há mais tempo. Só aparecem capturas de tela enviadas, nunca uma
prova cujo usuário final ainda não enviou um arquivo, e nunca uma de uma
carteira que você excluiu do seu catálogo de endereços (a Didit as
encerra como OWNERSHIP_CHANGED).
operationId: listTravelRuleWalletProofs
parameters:
- name: status
in: query
description: >-
Quais comprovantes listar. O padrão é PENDING, os que ainda aguardam
decisão.
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: >-
Comprovações por captura de tela paginadas. count é exato até 100 e
limitado a 100 acima disso.
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: Status desconhecido.
'401':
description: x-api-key ausente ou inválido.
'403':
description: O chamador não tem a permissão de transações.
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: >-
Identificador canônico da blockchain, por exemplo, ETH, BTC, SOL,
TRX.
holder_name:
type: string
is_ownership_verified:
type: boolean
description: >-
Se a entrada do catálogo de endereços tem a propriedade verificada,
por esta prova ou por outra.
transaction_id:
type: string
format: uuid
nullable: true
description: >-
A transação para cuja transferência da Travel Rule a sessão do
widget foi criada. Null para uma sessão criada sem um
transaction_id.
file_name:
type: string
nullable: true
content_type:
type: string
nullable: true
screenshot_url:
type: string
nullable: true
description: >-
Link com tempo limitado para a captura de tela enviada. Liste a fila
novamente para obter um link novo.
attempts:
type: integer
description: Quantos arquivos o usuário final enviou para esta comprovação.
failure_reason:
allOf:
- $ref: '#/components/schemas/TravelRuleWalletProofFailureReason'
description: >-
REVIEW_REJECTED após uma rejeição, OWNERSHIP_CHANGED quando a
carteira mudou de titular ou foi excluída antes de uma decisão.
Vazio nos demais casos.
method_chosen_at:
type: string
format: date-time
nullable: true
description: Quando o usuário final escolheu o método de captura de tela.
decided_at:
type: string
format: date-time
nullable: true
decided_by:
type: string
description: >-
Quem encerrou o comprovante: review: para um
revisor do console, review para uma decisão via chave de API, widget
ou sweeper quando a Didit o encerrou automaticamente. Vazio enquanto
PENDING.
review_note:
type: string
description: A nota enviada com a decisão. Vazia quando não há nenhuma.
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: >-
Por que uma prova de propriedade de carteira, ou sua última tentativa,
não chegou a VERIFIED. Vazio quando nada falhou. Uma prova PENDING pode
ter um motivo: a última tentativa falhou e o usuário final pode tentar
novamente. DEPOSIT_MISMATCH, DEPOSIT_STALE, TXID_REUSED e
REVIEW_REJECTED encerram a prova como REJECTED. SIGNATURE_INVALID: a
assinatura não corresponde à carteira e ao desafio.
SIGNATURE_UNSUPPORTED_SCHEME: a carteira assinou em um formato que a
Didit não verifica. DEPOSIT_NOT_FOUND, DEPOSIT_UNCONFIRMED,
DEPOSIT_LOOKUP_FAILED: o depósito de teste não pode ser lido ou ainda
não foi confirmado; a Didit continua verificando-o até a janela de teste
fechar. DEPOSIT_MISMATCH: a transação não envia o valor esperado da
carteira para o endereço de depósito. DEPOSIT_STALE: a transação é
anterior ao desafio. TXID_REUSED: a transação já comprovou outra
carteira. CHAIN_UNSUPPORTED: o método não está disponível nesta
blockchain. WINDOW_EXPIRED: a janela de teste fechou. OWNERSHIP_CHANGED:
o titular da carteira mudou, ou a carteira foi excluída do seu catálogo
de endereços, depois que a sessão do widget foi criada. METHOD_SWITCHED:
o usuário final escolheu outro método antes de concluir este.
REVIEW_REJECTED: seu revisor rejeitou a captura de tela. ABANDONED: a
sessão do widget expirou antes de o usuário final concluir.
securitySchemes:
ApiKeyAuth:
type: apiKey
in: header
name: x-api-key
description: >-
Chave de API da sua aplicação, em Developers -> API keys no Business
Console. A chave principal tem acesso total. Uma chave nomeada pode ter
escopo restrito: nenhum acesso, leitura ou escrita por recurso, limitada
a alguns fluxos ou a sessões aprovadas, a uma lista de endereços IP e a
uma data de validade. 401 significa que a chave está errada, revogada ou
expirada; 403 significa que nenhuma chave foi enviada, que a chave não
tem acesso a este recurso ou ação, ou que a requisição veio de um
endereço fora da sua lista de IPs; 404 em uma rota de sessão significa
que a sessão está fora dos fluxos ou status da chave. Uma chave sem
acesso a mídia recebe URLs de imagem, vídeo e PDF como null, e uma chave
sem permissão de escrita em sessões recebe links e tokens de sessão como
null. Consulte https://docs.didit.me/console/api-keys.
````
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.