> ## 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: фильтрация по типу и статусу, количество ошибок, пагинация и права на уровне приложения.

Асинхронный Reports API возвращает задания экспорта, которые можно просмотреть, начиная с самых новых. Используйте `failed_count` и `failed_item_ids`, чтобы найти экспорты верификаций с отдельными ошибками.

См. [руководство по экспорту и повторным попыткам](https://docs.didit.me/ru/console/export-pdf-csv.md#повторная-обработка-неудачных-элементов-экспорта), [получение одного отчёта](https://docs.didit.me/ru/management-api/reports/retrieve.md) или [повторная попытка экспорта](https://docs.didit.me/ru/management-api/reports/retry.md).


## OpenAPI

````yaml ru/openapi-25.json GET /v3/organization/{organization_id}/application/{application_id}/reports/
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/organization/{organization_id}/application/{application_id}/reports/:
    get:
      tags:
        - Reports
      summary: Список асинхронных отчётов
      description: >-
        Требуются права на чтение для каждого ресурса, который входит в отчёт.
        Учётные данные приложения или API-ключа должны принадлежать приложению
        из пути. Bearer-токены участников должны иметь доступ к приложению.
        Возвращает доступные отчёты, сначала самые новые. Эти асинхронные
        задания экспорта отделены от Regulatory Reports API. См. [Экспорт данных
        верификации](https://docs.didit.me/ru/console/export-pdf-csv).
      operationId: list_reports
      parameters:
        - name: organization_id
          in: path
          required: true
          schema:
            type: string
            format: uuid
          description: ID организации.
        - name: application_id
          in: path
          required: true
          schema:
            type: string
            format: uuid
          description: Идентификатор приложения.
        - name: limit
          in: query
          schema:
            type: integer
            default: 50
            minimum: 1
          description: Максимальное количество результатов на странице.
        - name: offset
          in: query
          schema:
            type: integer
            default: 0
            minimum: 0
          description: Количество результатов, которые нужно пропустить.
        - name: status
          in: query
          schema:
            type: string
          description: >-
            Значения status через запятую или повторяющимися параметрами:
            PENDING, PROCESSING, READY, FAILED.
        - name: report_type
          in: query
          schema:
            type: string
          description: Значения report_type через запятую или повторяющимися параметрами.
        - name: q
          in: query
          schema:
            type: string
          description: >-
            Поиск по фрагменту ID отчёта или по имени или адресу электронной
            почты инициатора (не более 255 символов).
      responses:
        '200':
          description: Список асинхронных отчётов.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AsyncReportList'
        '400':
          description: Недопустимый status, report_type или параметр фильтра поиска.
        '401':
          description: >-
            Учётные данные отсутствуют, недействительны или срок их действия
            истёк.
        '403':
          description: >-
            Вызывающая сторона не имеет доступа к этому приложению или
            необходимых разрешений.
        '429':
          $ref: '#/components/responses/RateLimitedRead'
      security:
        - ApiKeyAuth: []
        - BearerAuth: []
      x-codeSamples:
        - lang: python
          label: Python
          source: |-
            from didit import Didit

            # Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
            # and DIDIT_APPLICATION_ID.
            client = Didit()

            for item in client.reports.list():
                print(item)
        - lang: javascript
          label: Node.js
          source: |-
            import Didit from "@didit-protocol/sdk-node";

            // Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
            // and DIDIT_APPLICATION_ID.
            const didit = new Didit();

            for await (const item of didit.reports.list()) {
              console.log(item);
            }
        - lang: go
          label: Go
          source: "ctx := context.Background()\n// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID\n// and DIDIT_APPLICATION_ID.\nclient := didit.NewClient()\n\niter := client.Reports.ListAutoPaging(ctx, didit.ReportsListParams{})\nfor iter.Next() {\n\tfmt.Printf(\"%+v\\n\", iter.Current())\n}\nif err := iter.Err(); err != nil {\n\tlog.Fatal(err)\n}"
        - lang: java
          label: Java
          source: |-
            import me.didit.Didit;

            // Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
            // and DIDIT_APPLICATION_ID.
            Didit client = new Didit();

            for (var item : client.reports().list()) {
                System.out.println(item);
            }
        - lang: php
          label: PHP
          source: |-
            <?php

            require 'vendor/autoload.php';

            use Didit\DiditClient;

            // Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
            // and DIDIT_APPLICATION_ID.
            $didit = new DiditClient();

            foreach ($didit->reports->list() as $item) {
                print_r($item->toArray());
            }
        - lang: ruby
          label: Ruby
          source: |-
            require "didit"

            # Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
            # and DIDIT_APPLICATION_ID.
            didit = Didit::Client.new

            didit.reports.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, DIDIT_ORGANIZATION_ID
            // and DIDIT_APPLICATION_ID.
            using var client = new DiditClient();

            await foreach (var item in await client.Reports.ListAsync())
            {
                Console.WriteLine(JsonSerializer.Serialize(item));
            }
components:
  schemas:
    AsyncReportList:
      type: object
      required:
        - count
        - next
        - previous
        - results
        - counts
      properties:
        count:
          type: integer
          description: >-
            Количество результатов, обычно не более 100; может быть оценочным.
            Для остановки пагинации ориентируйтесь на next, а не на count.
        next:
          type: string
          description: URL следующей страницы или null.
          nullable: true
        previous:
          type: string
          description: URL предыдущей страницы или null.
          nullable: true
        results:
          type: array
          items:
            $ref: '#/components/schemas/AsyncReport'
        counts:
          type: object
          required:
            - report_type
            - status
          description: >-
            Количество всех отчётов, которые вызывающая сторона может читать, до
            применения фильтров списка.
          properties:
            report_type:
              type: object
              additionalProperties:
                type: integer
            status:
              type: object
              additionalProperties:
                type: integer
    AsyncReport:
      type: object
      required:
        - uuid
        - report_type
        - report_type_display
        - status
        - status_display
        - parameters
        - requested_by_user_id
        - requested_by_email
        - requested_by_name
        - row_count
        - failed_item_ids
        - failed_count
        - file_size
        - files
        - scheduled_report
        - error_message
        - deletion_pending
        - eta_seconds
        - started_at
        - completed_at
        - expires_at
        - created_at
        - updated_at
      properties:
        uuid:
          type: string
          description: Идентификатор отчёта.
          format: uuid
        report_type:
          type: string
          description: Тип экспорта или комплаенс-отчёта.
          enum:
            - SESSION_EXPORT
            - TRANSACTION_EXPORT
            - BUSINESS_EXPORT
            - VENDOR_USER_EXPORT
            - VENDOR_BUSINESS_EXPORT
            - CASE_EXPORT
            - CASE_SLA_EXPORT
            - LIST_ENTRY_EXPORT
            - EVENT_EXPORT
            - COMPLIANCE_KYC_KYB
            - COMPLIANCE_AML_LOG
            - COMPLIANCE_TRAVEL_RULE
            - COMPLIANCE_SANCTIONS_PEP
            - COMPLIANCE_RISK_SUMMARY
            - COMPLIANCE_SAR_STR_DRAFT
            - COMPLIANCE_CTR
            - COMPLIANCE_CASE_SUMMARY
        report_type_display:
          type: string
          description: Отображаемое название типа отчёта.
        status:
          type: string
          description: >-
            Состояние генерации. READY может включать отдельные сбои; проверьте
            failed_count.
          enum:
            - PENDING
            - PROCESSING
            - READY
            - FAILED
        status_display:
          type: string
          description: Отображаемое название состояния генерации.
        parameters:
          type: object
          description: Исходные параметры экспорта; ключи зависят от report_type.
          additionalProperties: true
        requested_by_user_id:
          type: string
          description: >-
            Идентификационные данные исходного запрашивающего или null для
            вызывающих сторон без идентификации пользователя.
          format: uuid
          nullable: true
        requested_by_email:
          type: string
          description: Адрес электронной почты запрашивающего, если доступен.
          nullable: true
        requested_by_name:
          type: string
          description: Отображаемое имя запрашивающего, если доступно.
          nullable: true
        row_count:
          type: integer
          description: Количество экспортированных записей или null до формирования отчёта.
          nullable: true
        failed_item_ids:
          type: array
          description: >-
            UUID сессий, завершившихся с ошибкой в этом экспорте верификации.
            Удалённые сессии исключаются. Используйте эти ID для выборочного
            повтора.
          items:
            type: string
            format: uuid
        failed_count:
          type: integer
          description: Количество записей в failed_item_ids.
          minimum: 0
        file_size:
          type: integer
          description: Общий размер созданного файла в байтах или null до генерации.
          format: int64
          nullable: true
        files:
          type: array
          description: >-
            Метаданные сгенерированного файла; не содержат ссылок для
            скачивания.
          items:
            $ref: '#/components/schemas/AsyncReportFile'
        scheduled_report:
          type: string
          description: Идентификатор расписания или null для отчёта без расписания.
          format: uuid
          nullable: true
        error_message:
          type: string
          description: Ошибка генерации, если доступна.
          nullable: true
        deletion_pending:
          type: boolean
          description: Выполняется ли ещё запрошенное удаление.
        eta_seconds:
          type: integer
          description: >-
            Оценка оставшегося времени до завершения для отчёта в статусе
            ожидания или обработки; null без истории или когда отчёт готов.
          nullable: true
        started_at:
          type: string
          description: Время начала генерации.
          format: date-time
          nullable: true
        completed_at:
          type: string
          description: Время завершения генерации.
          format: date-time
          nullable: true
        expires_at:
          type: string
          description: Время истечения срока действия отчёта.
          format: date-time
        created_at:
          type: string
          description: Время создания.
          format: date-time
        updated_at:
          type: string
          description: Время последнего обновления.
          format: date-time
      example:
        uuid: 00000000-0000-4000-8000-000000000002
        report_type: SESSION_EXPORT
        report_type_display: Verifications
        status: READY
        status_display: Ready
        parameters: {}
        requested_by_user_id: null
        requested_by_email: null
        requested_by_name: null
        row_count: 9
        failed_item_ids:
          - 00000000-0000-4000-8000-000000000001
        failed_count: 1
        file_size: 1200
        files:
          - name: verifications.csv
            format: csv
            rows: 9
            bytes: 1200
        scheduled_report: null
        error_message: null
        deletion_pending: false
        eta_seconds: null
        started_at: '2026-11-11T01:00:00Z'
        completed_at: '2026-11-11T01:01:00Z'
        expires_at: '2026-12-11T01:00:00Z'
        created_at: '2026-11-11T01:00:00Z'
        updated_at: '2026-11-11T01:01:00Z'
    RateLimitBudgetError:
      type: object
      description: >-
        Возвращается только при отказе middleware из-за исчерпания бюджета
        лимита запросов. Другие ошибки 429, включая конфликты идемпотентности и
        ограничения конкретного endpoint, не гарантируют эти поля метаданных.
      required:
        - detail
        - reference
        - limit
        - remaining
        - reset
        - window_seconds
      properties:
        detail:
          type: string
          description: Существующее понятное человеку сообщение об отказе по бюджету.
        reference:
          type: string
          pattern: ^RL-[0-9a-f]{32}$
          description: >-
            Непрозрачный идентификатор для службы поддержки: RL- и затем 32
            шестнадцатеричных символа UUID в нижнем регистре.
        limit:
          type: integer
          description: Бюджет области, в которой превышен лимит; равен X-RateLimit-Limit.
        remaining:
          type: integer
          minimum: 0
          description: >-
            Оставшийся бюджет, приведённый к нулю; совпадает с
            X-RateLimit-Remaining.
        reset:
          type: integer
          format: int64
          description: Время сброса окна в секундах Unix; равно X-RateLimit-Reset.
        window_seconds:
          type: integer
          description: >-
            Длительность фиксированного окна в секундах, а не оставшееся время
            ожидания. Учитывайте Retry-After перед повторной попыткой.
      example:
        detail: >-
          Write request rate limit exceeded. You can make up to 300 requests per
          minute.
        reference: RL-00000000000040008000000000000001
        limit: 300
        remaining: 0
        reset: 1794358860
        window_seconds: 60
    AsyncReportFile:
      type: object
      required:
        - name
        - format
        - rows
        - bytes
      properties:
        name:
          type: string
          description: Имя файла.
        format:
          type: string
          description: Формат файла.
        rows:
          type: integer
          description: Экспортированные записи в этом файле, если применимо.
          nullable: true
        bytes:
          type: integer
          description: Размер файла в байтах.
          format: int64
  responses:
    RateLimitedRead:
      description: >-
        Превышен лимит чтения middleware. Соблюдайте Retry-After перед повторной
        попыткой.
      headers:
        Retry-After:
          $ref: '#/components/headers/BudgetRetryAfter'
        X-RateLimit-Scope:
          $ref: '#/components/headers/BudgetXRateLimitScope'
        X-RateLimit-Limit:
          $ref: '#/components/headers/BudgetXRateLimitLimit'
        X-RateLimit-Remaining:
          $ref: '#/components/headers/BudgetXRateLimitRemaining'
        X-RateLimit-Reset:
          $ref: '#/components/headers/BudgetXRateLimitReset'
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/RateLimitBudgetError'
          example:
            detail: >-
              GET request rate limit exceeded. You can make up to 600 requests
              per minute.
            reference: RL-00000000000040008000000000000001
            limit: 600
            remaining: 0
            reset: 1794358860
            window_seconds: 60
  headers:
    BudgetRetryAfter:
      description: >-
        Секунды ожидания, округлённые вверх до следующего окна. Присутствует при
        отказах middleware из-за исчерпания бюджета.
      schema:
        type: integer
    BudgetXRateLimitScope:
      description: >-
        Область, бюджет которой превышен. Присутствует при отказах middleware
        из-за исчерпания бюджета.
      schema:
        type: string
    BudgetXRateLimitLimit:
      description: >-
        Бюджет области, в которой превышен лимит; равен лимиту в теле ответа.
        Присутствует при отказах по бюджету промежуточного ПО.
      schema:
        type: integer
    BudgetXRateLimitRemaining:
      description: >-
        Оставшийся бюджет, приведённый к нулю; совпадает с remaining в теле
        ответа. Присутствует в отказах из-за бюджета middleware.
      schema:
        type: integer
    BudgetXRateLimitReset:
      description: >-
        Время сброса в секундах Unix; равно reset в теле ответа. Присутствует
        при отказах middleware из-за исчерпания бюджета.
      schema:
        type: integer
  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.
    BearerAuth:
      type: http
      scheme: bearer
      description: Токен доступа приложения, полученный по учётным данным клиента.

````

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