> ## 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. # Recupera report asincrono: riferimento API > Recupera un report asincrono di Didit: stato, file, ID sessioni non riuscite e numero di errori prima di scegliere i nuovi tentativi. L'API asincrona Reports di Didit restituisce un job di esportazione e l'elenco attuale degli elementi non riusciti. `failed_count` è uguale alla lunghezza di `failed_item_ids`; le sessioni eliminate sono escluse. Trova il report con [Elenca i report asincroni](https://docs.didit.me/it/management-api/reports/list.md), poi segui le [indicazioni per il nuovo tentativo](https://docs.didit.me/it/console/export-pdf-csv.md#riprovare-gli-elementi-di-esportazione-non-riusciti) oppure [riprova l'esportazione](https://docs.didit.me/it/management-api/reports/retry.md). ## OpenAPI ````yaml it/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 di verifica dell'identità. Autenticati con l'intestazione 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: Recupera il report asincrono description: >- Richiede autorizzazioni di lettura per ogni risorsa coperta dal report. Le credenziali di applicazione o chiave API devono appartenere all'applicazione indicata nel percorso. I token Bearer di membro devono avere accesso all'applicazione. failed_item_ids esclude le sessioni eliminate; failed_count è la sua lunghezza. operationId: retrieve_reports parameters: - name: organization_id in: path required: true schema: type: string format: uuid description: ID dell'organizzazione. - name: application_id in: path required: true schema: type: string format: uuid description: ID dell'applicazione. - name: report_uuid in: path required: true schema: type: string format: uuid description: UUID del report. responses: '200': description: Recupera report asincrono. content: application/json: schema: $ref: '#/components/schemas/AsyncReport' '401': description: Credenziali mancanti, non valide o scadute. '403': description: >- Il chiamante non dispone dell'accesso a questa applicazione o delle autorizzazioni richieste. '404': description: Report non trovato in questa applicazione. '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: Identificatore del report. format: uuid report_type: type: string description: Tipo di esportazione o di report di conformità. 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: Etichetta visualizzata per il tipo di report. status: type: string description: >- Stato di generazione. READY può includere singoli errori; controlla failed_count. enum: - PENDING - PROCESSING - READY - FAILED status_display: type: string description: Etichetta visualizzata per lo stato di generazione. parameters: type: object description: >- Opzioni originali dell'esportazione; le chiavi dipendono da report_type. additionalProperties: true requested_by_user_id: type: string description: >- Identità del richiedente originale, oppure null per i chiamanti senza identità utente. format: uuid nullable: true requested_by_email: type: string description: Email del richiedente, quando disponibile. nullable: true requested_by_name: type: string description: Nome visualizzato del richiedente, quando disponibile. nullable: true row_count: type: integer description: Numero di record esportati, oppure null prima della generazione. nullable: true failed_item_ids: type: array description: >- UUID delle sessioni live non riuscite in questa esportazione della verifica. Le sessioni eliminate sono escluse. Usa questi ID per un nuovo tentativo selettivo. items: type: string format: uuid failed_count: type: integer description: Numero di voci in failed_item_ids. minimum: 0 file_size: type: integer description: >- Dimensione totale del file generato in byte, oppure null prima della generazione. format: int64 nullable: true files: type: array description: Metadati del file generato; non contiene URL di download. items: $ref: '#/components/schemas/AsyncReportFile' scheduled_report: type: string description: >- Identificatore della pianificazione, oppure null per un report non pianificato. format: uuid nullable: true error_message: type: string description: Errore di generazione, se disponibile. nullable: true deletion_pending: type: boolean description: Indica se un'eliminazione richiesta è ancora in corso. eta_seconds: type: integer description: >- Secondi stimati al completamento per un report in attesa o in elaborazione; null senza cronologia o quando è completato. nullable: true started_at: type: string description: Data di inizio della generazione. format: date-time nullable: true completed_at: type: string description: Data di completamento della generazione. format: date-time nullable: true expires_at: type: string description: Ora di scadenza del report. format: date-time created_at: type: string description: Data di creazione. format: date-time updated_at: type: string description: Data dell'ultimo aggiornamento. 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: Nome del file. format: type: string description: Formato del file. rows: type: integer description: Record esportati in questo file, ove applicabile. nullable: true bytes: type: integer description: Dimensione del file in byte. format: int64 RateLimitBudgetError: type: object description: >- Restituito solo per un rifiuto del budget del middleware del limite di frequenza. Altri errori 429, inclusi i conflitti di idempotenza e i limiti specifici dell'endpoint, non garantiscono questi campi di metadati. required: - detail - reference - limit - remaining - reset - window_seconds properties: detail: type: string description: Messaggio di rifiuto per budget leggibile, già esistente. reference: type: string pattern: ^RL-[0-9a-f]{32}$ description: >- Riferimento di supporto opaco: RL- seguito da 32 caratteri esadecimali minuscoli di un UUID. limit: type: integer description: Budget per l'ambito superato; equivale a X-RateLimit-Limit. remaining: type: integer minimum: 0 description: Budget residuo, limitato a zero; equivale a X-RateLimit-Remaining. reset: type: integer format: int64 description: >- Orario di reset della finestra in secondi Unix; coincide con X-RateLimit-Reset. window_seconds: type: integer description: >- Durata della finestra fissa in secondi, non il tempo di attesa residuo. Rispetta Retry-After prima di riprovare. 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: >- Budget di lettura del middleware superato. Rispetta Retry-After prima di riprovare. 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: >- Secondi di attesa, arrotondati alla finestra successiva. Presente nei rifiuti per budget del middleware. schema: type: integer BudgetXRateLimitScope: description: >- L'ambito il cui budget è stato superato. Presente nei rifiuti per budget del middleware. schema: type: string BudgetXRateLimitLimit: description: >- Budget per l'ambito superato; equivale al limite nel corpo. Presente nei rifiuti per budget del middleware. schema: type: integer BudgetXRateLimitRemaining: description: >- Budget residuo, limitato a zero; equivale a remaining nel corpo. Presente nei rifiuti per budget del middleware. schema: type: integer BudgetXRateLimitReset: description: >- Orario di reset in secondi Unix; coincide con il reset nel corpo. Presente nei rifiuti per budget del middleware. schema: type: integer securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- La chiave API della tua applicazione, da Developers -> API keys nella Business Console. La chiave primaria ha accesso completo. Una chiave con nome può avere un ambito definito: nessuno, lettura o scrittura per risorsa, limitata ad alcuni workflow o a sessioni approvate, a un elenco di indirizzi IP e a una data di scadenza. 401 indica che la chiave è errata, revocata o scaduta; 403 indica che non è stata inviata alcuna chiave, che la chiave non ha accesso a questa risorsa o azione, oppure che la richiesta proviene da un indirizzo non incluso nel suo elenco IP; 404 su una route di sessione indica che la sessione non rientra nei workflow o negli stati previsti dalla chiave. Una chiave senza accesso ai media riceve gli URL di immagini, video e PDF come null, e una chiave senza permessi di scrittura sulle sessioni riceve link e token di sessione come null. Consulta https://docs.didit.me/console/api-keys. BearerAuth: type: http scheme: bearer description: Il token di accesso client-credentials dell'applicazione. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.