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

# webhook गंतव्य विश्लेषण API

> Didit का API किसी एक webhook गंतव्य के लिए डिलीवरी कुल, विफलता दर और रिस्पॉन्स समय देता है, कुल और प्रति UTC दिन, किसी भी तिथि सीमा के लिए।



Webhook गंतव्य विश्लेषण प्राप्त करने का API प्रॉम्प्ट
        प्रॉम्प्ट को क्लिपबोर्ड पर कॉपी करें



      
      

\<pre>

\`Read delivery statistics for one Didit webhook destination through the Management API.

Endpoint:
GET https://verification.didit.me/v3/webhook/destinations/{destination_uuid}/analytics/

Authentication:
Use the x-api-key header with my Didit API key. A scoped API key needs webhooks: read.

Goal:
\- Measure how reliably and how fast my endpoint accepts webhooks, to alert on failures or chart delivery health.

Path parameter:
\- destination_uuid: the destination uuid from GET /v3/webhook/destinations/.

Query parameters (optional):
\- date_from, date_to: UTC days as YYYY-MM-DD, both inclusive. Without them, every delivery of the destination is included. Delivery records are available for about 30 days, so no range reaches further back.

Behavior:
\- summary: total_deliveries, failed_deliveries, error_rate_percentage (whole number, 0 when there are no deliveries), min_response_time_ms, avg_response_time_ms, max_response_time_ms (null when there is no data). A delivery not attempted yet counts in total_deliveries, never in failed_deliveries, and has no response time.
\- points: one entry per UTC day that had deliveries, oldest first, with the same counters plus date. Days without deliveries are omitted, so fill the gaps with zeros when you chart them.
\- Every attempt counts: the first send of an event, each automatic retry and each resend.
\- Failed means HTTP 400 or above. A timeout is recorded as 504 and a connection failure as 503, so both count as failed.

Example call:
curl -X GET "https://verification.didit.me/v3/webhook/destinations/{destination_uuid}/analytics/?date_from=2026-05-01&date_to=2026-05-31" \
-H "x-api-key: YOUR_API_KEY"

Failure modes:
\- 400: { "date_from": ["Date has wrong format. Use one of these formats instead: YYYY-MM-DD."] } or { "date_to": ["date_to must be greater than or equal to date_from."] }
\- 401: { "detail": "This API key has expired." }
\- 403: { "detail": "You do not have permission to perform this action." } or { "detail": "This API key has no read access to webhooks." }
\- 404: { "detail": "Webhook destination not found." }
\- 429: more than 600 GET requests per minute with this key; wait for Retry-After.

Side effects: none. This is a pure read.

For the full integration shape, see /integration/integration-prompt.`

\</pre>



      
      

यहाँ पेस्ट करें

इस endpoint का उपयोग करके आप चुनी गई अवधि में किसी webhook गंतव्य की निगरानी कर सकते हैं। किसी विफलता से जुड़े अलग-अलग प्रयास देखने के लिए, उन्हें [Webhook गंतव्य डिलीवरी सूची](https://docs.didit.me/hi/management-api/webhook/list-deliveries.md) से सूचीबद्ध करें और [Webhook गंतव्य डिलीवरी प्राप्त करें](https://docs.didit.me/hi/management-api/webhook/get-delivery.md) से किसी एक को खोलें।कौन-से रिस्पॉन्स Didit अपने आप पुनः प्रयास करता है, यह [पुनः प्रयास नीति](https://docs.didit.me/hi/integration/webhooks.md#पुनः-प्रयास-नीति) में बताया गया है।


## OpenAPI

````yaml hi/openapi-25.json GET /v3/webhook/destinations/{destination_uuid}/analytics/
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/webhook/destinations/{destination_uuid}/analytics/:
    get:
      tags:
        - Webhook
      summary: webhook गंतव्य एनालिटिक्स प्राप्त करें
      description: >-
        पूरी सीमा (`summary`) और प्रति UTC दिन (`points`) में एक webhook गंतव्य
        के लिए डिलीवरी योग, विफलता दर और रिस्पॉन्स समय। प्रत्येक प्रयास को एक
        डिलीवरी माना जाता है: किसी इवेंट का पहला भेजना, प्रत्येक स्वचालित [पुनः
        प्रयास](https://docs.didit.me/hi/integration/webhooks#पुनः-प्रयास-नीति)
        और प्रत्येक पुनः भेजना। एक डिलीवरी तब विफल मानी जाती है जब उसका रिकॉर्ड
        किया गया HTTP स्टेटस 400 या उससे अधिक हो, इसलिए टाइमआउट (`504` के रूप
        में दर्ज) और कनेक्शन विफलताएं (`503`) विफल मानी जाती हैं; अभी भी कतार
        में मौजूद डिलीवरी केवल `total_deliveries` में गिनी जाती है। डिलीवरी
        रिकॉर्ड लगभग 30 दिनों के लिए उपलब्ध रहते हैं। स्कोप्ड API कुंजी के लिए
        `webhooks: read` की आवश्यकता होती है।
      operationId: get_webhook_destination_analytics
      parameters:
        - name: destination_uuid
          in: path
          required: true
          description: >-
            गंतव्य का UUID (`GET /v3/webhook/destinations/` द्वारा लौटाया गया
            `uuid`)।
          schema:
            type: string
            format: uuid
          example: 11111111-2222-3333-4444-555555555555
        - name: date_from
          in: query
          required: false
          description: >-
            शामिल करने के लिए पहला UTC दिन, `YYYY-MM-DD` के रूप में (समावेशी)।
            उपलब्ध सबसे पुरानी डिलीवरी से शुरू करने के लिए छोड़ दें। `dateFrom`
            को एक उपनाम के रूप में स्वीकार किया जाता है।
          schema:
            type: string
            format: date
          example: '2026-10-01'
        - name: date_to
          in: query
          required: false
          description: >-
            शामिल करने के लिए अंतिम UTC दिन, `YYYY-MM-DD` के रूप में (समावेशी)।
            यह `date_from` से पहले का नहीं होना चाहिए। `dateTo` को एक उपनाम के
            रूप में स्वीकार किया जाता है।
          schema:
            type: string
            format: date
          example: '2026-10-16'
      responses:
        '200':
          description: गंतव्य के लिए डिलीवरी आंकड़े।
          content:
            application/json:
              schema:
                type: object
                required:
                  - summary
                  - points
                properties:
                  summary:
                    type: object
                    description: अनुरोधित सीमा के कुल योग।
                    required:
                      - total_deliveries
                      - failed_deliveries
                      - min_response_time_ms
                      - avg_response_time_ms
                      - max_response_time_ms
                      - error_rate_percentage
                    properties:
                      total_deliveries:
                        type: integer
                        minimum: 0
                        description: डिलीवरी प्रयास, कतारबद्ध प्रयासों सहित।
                      failed_deliveries:
                        type: integer
                        minimum: 0
                        description: >-
                          ऐसे प्रयास जिनकी रिकॉर्ड की गई HTTP स्थिति 400 या उससे
                          अधिक है।
                      min_response_time_ms:
                        type: integer
                        nullable: true
                        description: >-
                          मिलीसेकंड में सबसे तेज़ प्रयास, या `null` जब किसी भी
                          प्रयास का कोई रिकॉर्ड किया गया समय नहीं होता है।
                      avg_response_time_ms:
                        type: integer
                        nullable: true
                        description: >-
                          मिलीसेकंड में औसत प्रयास समय, पूर्णांकित, या `null` जब
                          किसी भी प्रयास का समय रिकॉर्ड नहीं किया गया हो।
                      max_response_time_ms:
                        type: integer
                        nullable: true
                        description: >-
                          मिलीसेकंड में सबसे धीमा प्रयास, या जब किसी प्रयास का
                          कोई समय रिकॉर्ड न हो तो `null`।
                      error_rate_percentage:
                        type: integer
                        minimum: 0
                        maximum: 100
                        description: >-
                          `failed_deliveries` / `total_deliveries` x 100, निकटतम
                          पूर्णांक तक पूर्णांकित। जब कोई डिलीवरी न हो तो `0`।
                  points:
                    type: array
                    description: >-
                      डिलीवरी वाले प्रति UTC दिन एक प्रविष्टि, सबसे पुरानी पहले।
                      बिना डिलीवरी वाले दिनों को छोड़ दिया जाता है, इसलिए जब आप
                      उन्हें चार्ट करते हैं तो अंतरालों को शून्य से भरें।
                    items:
                      type: object
                      required:
                        - date
                        - total_deliveries
                        - failed_deliveries
                        - min_response_time_ms
                        - avg_response_time_ms
                        - max_response_time_ms
                      properties:
                        date:
                          type: string
                          format: date
                          description: UTC दिन, `YYYY-MM-DD`।
                        total_deliveries:
                          type: integer
                          minimum: 0
                          description: डिलीवरी प्रयास, कतारबद्ध प्रयासों सहित।
                        failed_deliveries:
                          type: integer
                          minimum: 0
                          description: >-
                            ऐसे प्रयास जिनकी रिकॉर्ड की गई HTTP स्थिति 400 या
                            उससे अधिक है।
                        min_response_time_ms:
                          type: integer
                          nullable: true
                          description: >-
                            मिलीसेकंड में सबसे तेज़ प्रयास, या `null` जब किसी भी
                            प्रयास का कोई रिकॉर्ड किया गया समय नहीं होता है।
                        avg_response_time_ms:
                          type: integer
                          nullable: true
                          description: >-
                            मिलीसेकंड में औसत प्रयास समय, पूर्णांकित, या `null`
                            जब किसी भी प्रयास का समय रिकॉर्ड नहीं किया गया हो।
                        max_response_time_ms:
                          type: integer
                          nullable: true
                          description: >-
                            मिलीसेकंड में सबसे धीमा प्रयास, या जब किसी प्रयास का
                            कोई समय रिकॉर्ड न हो तो `null`।
              examples:
                Three days of deliveries:
                  value:
                    summary:
                      total_deliveries: 1250
                      failed_deliveries: 12
                      min_response_time_ms: 38
                      avg_response_time_ms: 164
                      max_response_time_ms: 5004
                      error_rate_percentage: 1
                    points:
                      - date: '2026-10-14'
                        total_deliveries: 410
                        failed_deliveries: 0
                        min_response_time_ms: 38
                        avg_response_time_ms: 152
                        max_response_time_ms: 911
                      - date: '2026-10-15'
                        total_deliveries: 395
                        failed_deliveries: 12
                        min_response_time_ms: 41
                        avg_response_time_ms: 190
                        max_response_time_ms: 5004
                      - date: '2026-10-16'
                        total_deliveries: 445
                        failed_deliveries: 0
                        min_response_time_ms: 40
                        avg_response_time_ms: 151
                        max_response_time_ms: 1220
                No deliveries in range:
                  value:
                    summary:
                      total_deliveries: 0
                      failed_deliveries: 0
                      min_response_time_ms: null
                      avg_response_time_ms: null
                      max_response_time_ms: null
                      error_rate_percentage: 0
                    points: []
        '400':
          description: >-
            `date_from` या `date_to` कोई `YYYY-MM-DD` तिथि नहीं है, या `date_to`
            `date_from` से पहले की है।
          content:
            application/json:
              schema:
                type: object
                description: प्रत्येक अमान्य फ़ील्ड को संदेशों की सूची से मैप किया गया है।
                additionalProperties:
                  type: array
                  items:
                    type: string
              examples:
                Malformed date:
                  value:
                    date_from:
                      - >-
                        Date has wrong format. Use one of these formats instead:
                        YYYY-MM-DD.
                Reversed range:
                  value:
                    date_to:
                      - date_to must be greater than or equal to date_from.
        '401':
          description: >-
            API कुंजी की समय-सीमा समाप्त हो गई है: इसे एक समाप्ति तिथि के साथ
            बनाया गया था जो बीत चुकी है। किसी गलत या निरस्त की गई कुंजी पर भी
            `401` मिलता है; अनुपलब्ध कुंजी पर `403` मिलता है।
          content:
            application/json:
              schema:
                type: object
                properties:
                  detail:
                    type: string
                    description: मानव-पठनीय त्रुटि संदेश।
              examples:
                Expired key:
                  value:
                    detail: This API key has expired.
        '403':
          description: >-
            अनुरोध की अनुमति नहीं है। अनुपलब्ध, अमान्य या निरस्त `x-api-key` पर
            `You do not have permission to perform this action.` मिलता है। इस
            endpoint के लिए आवश्यक एक्सेस के बिना स्कोप्ड कुंजी होने पर अनुपलब्ध
            एक्सेस का नाम बताते हुए एक संदेश मिलता है, और इसकी IP allowlist के
            बाहर से उपयोग की गई कुंजी पर `This API key can't be used from this
            IP address.` मिलता है।
          content:
            application/json:
              schema:
                type: object
                properties:
                  detail:
                    type: string
                    description: मानव-पठनीय त्रुटि संदेश।
              examples:
                Missing or invalid key:
                  value:
                    detail: You do not have permission to perform this action.
                Scoped key without webhooks read:
                  value:
                    detail: This API key has no read access to webhooks.
                Outside the IP allowlist:
                  value:
                    detail: This API key can't be used from this IP address.
        '404':
          description: >-
            एप्लिकेशन के लिए इस UUID वाला कोई गंतव्य मौजूद नहीं है, या इसे हटा
            दिया गया है।
          content:
            application/json:
              schema:
                type: object
                properties:
                  detail:
                    type: string
                    description: मानव-पठनीय त्रुटि संदेश।
              examples:
                Destination not found:
                  value:
                    detail: Webhook destination not found.
        '429':
          description: >-
            रेट लिमिट पार हो गई: इस API कुंजी के लिए वर्तमान एक मिनट की विंडो
            में 600 से अधिक GET अनुरोध। पुनः प्रयास करने से पहले `Retry-After`
            सेकंड प्रतीक्षा करें।
          headers:
            Retry-After:
              description: पुनः प्रयास करने से पहले प्रतीक्षा करने के सेकंड।
              schema:
                type: integer
                minimum: 1
                example: 30
            X-RateLimit-Limit:
              description: एक मिनट की विंडो में अनुमत अनुरोध (600)।
              schema:
                type: integer
                example: 600
            X-RateLimit-Remaining:
              description: वर्तमान विंडो में शेष अनुरोध।
              schema:
                type: integer
                example: 0
            X-RateLimit-Reset:
              description: Unix समय (सेकंड) जब वर्तमान विंडो रीसेट होती है।
              schema:
                type: integer
                example: 1792056120
            X-RateLimit-Scope:
              description: उस बजट का नाम जो पार हो गया था।
              schema:
                type: string
                example: generic-get
          content:
            application/json:
              schema:
                type: object
                properties:
                  detail:
                    type: string
                    description: मानव-पठनीय त्रुटि संदेश।
              examples:
                Throttled:
                  value:
                    detail: >-
                      GET request rate limit exceeded. You can make up to 600
                      requests per minute.
      security:
        - ApiKeyAuth: []
      x-codeSamples:
        - lang: curl
          label: curl
          source: >-
            curl -X GET
            'https://verification.didit.me/v3/webhook/destinations/11111111-2222-3333-4444-555555555555/analytics/?date_from=2026-10-01&date_to=2026-10-16'
            \
              -H 'x-api-key: YOUR_API_KEY'
        - lang: python
          label: Python
          source: |-
            from didit import Didit

            # Reads DIDIT_API_KEY.
            client = Didit()

            result = client.webhooks.destinations.retrieve_analytics(
                "11111111-2222-3333-4444-555555555555",
            )
            print(result)
        - lang: javascript
          label: Node.js
          source: >-
            import Didit from "@didit-protocol/sdk-node";


            // Reads DIDIT_API_KEY.

            const didit = new Didit();


            const result = await
            didit.webhooks.destinations.retrieveAnalytics("11111111-2222-3333-4444-555555555555");

            console.log(result);
        - lang: go
          label: Go
          source: "ctx := context.Background()\n// Reads DIDIT_API_KEY.\nclient := didit.NewClient()\n\nresult, err := client.Webhooks.Destinations.RetrieveAnalytics(ctx, \"11111111-2222-3333-4444-555555555555\", didit.WebhooksDestinationsRetrieveAnalyticsParams{})\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 client = new Didit();


            var result =
            client.webhooks().destinations().retrieveAnalytics("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 = new DiditClient();


            $result =
            $didit->webhooks->destinations->retrieveAnalytics('11111111-2222-3333-4444-555555555555');

            print_r($result->toArray());
        - lang: ruby
          label: Ruby
          source: >-
            require "didit"


            # Reads DIDIT_API_KEY.

            didit = Didit::Client.new


            result =
            didit.webhooks.destinations.retrieve_analytics("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.

            using var client = new DiditClient();


            var result = await
            client.Webhooks.Destinations.RetrieveAnalyticsAsync("11111111-2222-3333-4444-555555555555");

            Console.WriteLine(JsonSerializer.Serialize(result));
components:
  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।

````

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