> ## 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 > Получите асинхронный отчёт Didit со статусом генерации, файлами, ID сессий с ошибками и их числом перед выбором элементов для повторной попытки. Асинхронный API отчётов Didit возвращает задачу экспорта и текущий список элементов с ошибками. `failed_count` равен длине `failed_item_ids`; удалённые сессии исключаются. Найдите отчёт с помощью [списка асинхронных отчётов](https://docs.didit.me/ru/management-api/reports/list.md), затем следуйте [рекомендациям по повторной попытке](https://docs.didit.me/ru/console/export-pdf-csv.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/{report_uuid}/ 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/{report_uuid}/: get: tags: - Reports summary: Получить асинхронный отчёт description: >- Требуются права на чтение для каждого ресурса, который входит в отчёт. Учётные данные приложения или API-ключа должны принадлежать приложению из пути. Bearer-токены участников должны иметь доступ к приложению. failed_item_ids исключает удалённые сессии; failed_count равен длине списка failed_item_ids. operationId: retrieve_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: report_uuid in: path required: true schema: type: string format: uuid description: UUID отчёта. responses: '200': description: Получить асинхронный отчёт. content: application/json: schema: $ref: '#/components/schemas/AsyncReport' '401': description: >- Учётные данные отсутствуют, недействительны или срок их действия истёк. '403': description: >- Вызывающая сторона не имеет доступа к этому приложению или необходимых разрешений. '404': 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() result = client.reports.retrieve( "11111111-2222-3333-4444-555555555555", ) print(result) - 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(); const result = await didit.reports.retrieve("11111111-2222-3333-4444-555555555555"); console.log(result); - 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\nresult, err := client.Reports.Retrieve(ctx, \"11111111-2222-3333-4444-555555555555\")\nif err != nil {\n\tlog.Fatal(err)\n}\nfmt.Printf(\"%+v\\n\", result)" - lang: java label: Java source: >- import me.didit.Didit; // Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID // and DIDIT_APPLICATION_ID. Didit client = new Didit(); var result = client.reports().retrieve("11111111-2222-3333-4444-555555555555"); System.out.println(result); - lang: php label: PHP source: >- reports->retrieve('11111111-2222-3333-4444-555555555555'); print_r($result->toArray()); - lang: ruby label: Ruby source: >- require "didit" # Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID # and DIDIT_APPLICATION_ID. didit = Didit::Client.new result = didit.reports.retrieve("11111111-2222-3333-4444-555555555555") puts result.to_h - 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(); var result = await client.Reports.RetrieveAsync("11111111-2222-3333-4444-555555555555"); Console.WriteLine(JsonSerializer.Serialize(result)); components: schemas: 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' 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 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 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.