> ## 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.

# Travel Rule API: скриншоты подтверждений кошельков

> Получите список скриншотов подтверждения владения кошельком, ожидающих проверки, от старых к новым: изображение, кошелёк, транзакция и история. Didit.

Промпт API: список подтверждений кошельков
Скопировать промпт в буфер обмена

<pre>
  \`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.\`
</pre>

Вставьте в


## OpenAPI

````yaml ru/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 не может
        проверить автоматически: после загрузки конечным пользователем из
        виджета оно остаётся в статусе PENDING, пока вы не одобрите или не
        отклоните его с помощью POST
        /v3/travel-rule/wallet-proofs/{proof_uuid}/decision/. Сначала самые
        старые, поэтому очередь обрабатывается начиная с подтверждения, которое
        ожидает дольше всего. Отображаются только загруженные скриншоты;
        подтверждения, для которых конечный пользователь ещё не загрузил файл,
        или подтверждения для кошелька, удалённого вами из адресной книги (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 для больших значений.
          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: |-
            <?php

            require 'vendor/autoload.php';

            use Didit\DiditClient;

            // Reads DIDIT_API_KEY.
            $didit = new DiditClient();

            foreach ($didit->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 которой была создана сессия
            виджета. Null для сессии, созданной без transaction_id.
        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:<user identifier> для проверяющего
            из консоли, review для решения по API-ключу, widget или sweeper,
            если Didit закрыл его автоматически. Пусто, пока статус 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-ключ вашего приложения из раздела «Разработчикам» -> «API-ключи» в
        Business Console. Основной ключ имеет полный доступ. Именованный ключ
        может иметь ограниченную область действия: без доступа, чтение или
        запись для каждого ресурса, ограничение определенными сценариями или
        одобренными сессиями, списком IP-адресов и сроком действия. 401
        означает, что ключ неверен, отозван или его срок действия истек; 403
        означает, что ключ не был передан, у ключа нет доступа к этому ресурсу
        или действию, либо запрос поступил с адреса вне его списка IP-адресов;
        404 на маршруте сессии означает, что сессия не входит в сценарии или
        статусы ключа. Ключ без доступа к медиа получает URL изображений, видео
        и PDF как null, а ключ без прав на запись сессий получает ссылки на
        сессии и токены как null. См. https://docs.didit.me/console/api-keys.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.