> ## 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 (Async Reports)

> Didit के async एक्सपोर्ट रिपोर्ट सूचीबद्ध करें, प्रकार या स्थिति से फ़िल्टर करें, और एप्लिकेशन-स्कोप्ड अनुमतियों व पेजिनेशन के साथ विफलता गिनती देखें।

Didit का असिंक्रोनस Reports API ऐसे एक्सपोर्ट जॉब्स की सूची दिखाता है जिन्हें आप पढ़ सकते हैं, जिसमें नवीनतम जॉब सबसे पहले होता है। सत्यापन एक्सपोर्ट में अलग-अलग विफलताओं की पहचान के लिए `failed_count` और `failed_item_ids` का उपयोग करें।

देखें: [एक्सपोर्ट और पुनः प्रयास का मार्गदर्शन](https://docs.didit.me/hi/console/export-pdf-csv.md#विफल-एक्सपोर्ट-आइटम-के-लिए-पुनः-प्रयास-करें), [एक रिपोर्ट प्राप्त करें](https://docs.didit.me/hi/management-api/reports/retrieve.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/
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 token के पास एप्लिकेशन तक पहुँच होनी चाहिए।
        पढ़ने योग्य रिपोर्ट सबसे नई पहले क्रम में लौटाई जाती हैं। ये असिंक्रोनस
        एक्सपोर्ट जॉब Regulatory Reports API से अलग हैं। देखें [सत्यापन डेटा
        एक्सपोर्ट करें](https://docs.didit.me/hi/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 तक सीमित; यह अनुमानित हो सकती है।
            पेजिनेशन रोकने के लिए count के बजाय next का उपयोग करें।
        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: बनाई गई फ़ाइल का मेटाडेटा; इसमें डाउनलोड 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'
    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
    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: >-
        मिडलवेयर रीड बजट पार हो गया है। पुनः प्रयास करने से पहले 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.