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

# Async रिपोर्ट पुनर्प्राप्त करें API

> Didit की async रिपोर्ट प्राप्त करें: जनरेशन स्थिति, फ़ाइलें, विफल सत्र ID और विफलता गणना, पुनः प्रयास के लिए आइटम चुनने से पहले।

Didit का async Reports API एक एक्सपोर्ट जॉब और उसकी वर्तमान विफलताओं की सूची लौटाता है। `failed_count` का मान `failed_item_ids` की लंबाई के बराबर होता है; हटाए गए सत्र इसमें शामिल नहीं किए जाते।

[async रिपोर्ट सूचीबद्ध करें](https://docs.didit.me/hi/management-api/reports/list.md) का उपयोग करके रिपोर्ट खोजें, फिर [पुनः प्रयास संबंधी मार्गदर्शन](https://docs.didit.me/hi/console/export-pdf-csv.md#विफल-एक्सपोर्ट-आइटम-के-लिए-पुनः-प्रयास-करें) का पालन करें या [एक्सपोर्ट का पुनः प्रयास करें](https://docs.didit.me/hi/management-api/reports/retry.md)।


## OpenAPI

````yaml hi/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 token के पास एप्लिकेशन तक पहुँच होनी चाहिए। failed_item_ids
        हटाए गए सत्रों को बाहर रखता है; failed_count उसकी लंबाई है।
      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: >-
            <?php


            require 'vendor/autoload.php';


            use Didit\DiditClient;


            // Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID

            // and DIDIT_APPLICATION_ID.

            $didit = new DiditClient();


            $result =
            $didit->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: बनाई गई फ़ाइल का मेटाडेटा; इसमें डाउनलोड URL शामिल नहीं होते।
          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: >-
        यह केवल रेट-लिमिट मिडलवेयर बजट अस्वीकृति के लिए लौटाया जाता है। अन्य 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: >-
        मिडलवेयर रीड बजट पार हो गया है। पुनः प्रयास करने से पहले 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: >-
        प्रतीक्षा के सेकंड, जिन्हें अगली विंडो तक ऊपर की ओर राउंड किया गया है।
        मिडलवेयर बजट अस्वीकृतियों पर मौजूद होता है।
      schema:
        type: integer
    BudgetXRateLimitScope:
      description: वह दायरा जिसका बजट पार हुआ। मिडलवेयर बजट अस्वीकृतियों पर मौजूद होता है।
      schema:
        type: string
    BudgetXRateLimitLimit:
      description: >-
        सीमा से अधिक हुए दायरे का बजट; यह बॉडी लिमिट के बराबर है। यह middleware
        बजट अस्वीकृतियों में मौजूद होता है।
      schema:
        type: integer
    BudgetXRateLimitRemaining:
      description: >-
        शेष बजट, शून्य पर सीमित; body remaining के बराबर। मिडलवेयर बजट
        अस्वीकृतियों पर मौजूद।
      schema:
        type: integer
    BudgetXRateLimitReset:
      description: >-
        रीसेट का समय Unix सेकंड में; यह बॉडी के reset के बराबर होता है। मिडलवेयर
        बजट अस्वीकृतियों पर मौजूद होता है।
      schema:
        type: integer
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: >-
        आपकी एप्लिकेशन की API कुंजी, Business Console में Developers -> API keys
        से। प्राथमिक कुंजी के पास पूर्ण एक्सेस होता है। एक नामित कुंजी को स्कोप
        किया जा सकता है: प्रति संसाधन none, read या write, कुछ वर्कफ़्लो या
        स्वीकृत सत्रों तक सीमित, IP पतों की सूची तक सीमित, और समाप्ति तिथि तक
        सीमित। 401 का अर्थ है कि कुंजी गलत है, निरस्त कर दी गई है या उसकी
        समय-सीमा समाप्त हो गई है; 403 का अर्थ है कि कोई कुंजी नहीं भेजी गई थी,
        कुंजी के पास इस संसाधन या कार्रवाई का एक्सेस नहीं है, या अनुरोध उसकी IP
        सूची से बाहर के पते से आया था; सत्र रूट पर 404 का अर्थ है कि सत्र कुंजी
        के वर्कफ़्लो या स्थितियों से बाहर है। मीडिया एक्सेस के बिना एक कुंजी को
        छवि, वीडियो और PDF URL null के रूप में प्राप्त होते हैं, और सत्र write
        के बिना एक कुंजी को सत्र लिंक और token 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.