> ## 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 गंतव्य प्राप्त करें: Management API

> Didit Management API से webhook गंतव्य को साइनिंग सीक्रेट, इवेंट, स्थिति और 30-दिन के डिलीवरी सारांश सहित प्राप्त करें। प्रति कॉल भुगतान।



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



      
      

\<pre>

\`Fetch a single Didit webhook destination through the Management API.

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

Authentication:
Use the x-api-key header with my Didit API key.

Goal:
\- Retrieve the full configuration and delivery summary of one destination — useful for back-office detail screens or to confirm a config change.

Path parameter:
\- destination_uuid — the destination UUID returned by POST /v3/webhook/destinations/ or GET /v3/webhook/destinations/.

What to read from the response:
\- url, label, enabled, webhook_version — basic config.
\- subscribed_events — current event subscription list.
\- secret_shared_key: the HMAC signing secret, always returned in full to your API key.
\- secret_last4: the last four characters of the current secret.
\- previous_secret_expires_at: set for 24 hours after the secret is rotated in the Business Console. Until then every delivery also carries X-Signature-Previous, X-Signature-V2-Previous and X-Signature-Simple-Previous, made with the replaced secret. null otherwise.
\- health_status: "failing" (3 or more consecutive events failed their first delivery attempt since the last success), "degraded" (an attempt failed in the last 24 hours and no later attempt has delivered that event) or "healthy". failing_streak, failing_since and last_success_at give the details.
\- summary: { total_deliveries, failed_deliveries, error_rate_percentage, min/avg/max_response_time_ms, last_delivery_at, metrics_window_days } for the last 30 days (metrics_window_days is always 30; last_delivery_at is the most recent attempt).
\- created_by_email, created_by_name: the Business Console member who created the destination; null for a destination created with an API key.
\- environment: "live" or "sandbox", from the application.

Example call:
curl -X GET "https://verification.didit.me/v3/webhook/destinations/{destination_uuid}/" \
-H "x-api-key: YOUR_API_KEY"

Failure modes:
\- 401 — missing or malformed x-api-key.
\- 403: canonical { "detail": "You do not have permission to perform this action." } envelope.
\- 404 — destination not found in this application (also returned for deleted destinations).

Side effects: none. This is a pure read.

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

\</pre>



      
      

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

रिस्पॉन्स में [सूची](https://docs.didit.me/hi/management-api/webhook/list-destinations.md#गंतव्य-की-स्थिति) में मौजूद समान स्थिति फ़ील्ड होते हैं, साथ ही पिछले 30 दिनों का `summary` भी।## संबंधित- [webhook गंतव्यों की सूची](https://docs.didit.me/hi/management-api/webhook/list-destinations.md): हर गंतव्य, उसकी स्थिति और प्रतिदिन की डिलीवरी गिनती के साथ।
- [webhook गाइड](https://docs.didit.me/hi/integration/webhooks.md#हस्ताक्षर-सत्यापन): हस्ताक्षर सत्यापन कैसे करें, जिसमें सीक्रेट रोटेशन के दौरान भी सत्यापन शामिल है।


## OpenAPI

````yaml hi/openapi-25.json GET /v3/webhook/destinations/{destination_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/webhook/destinations/{destination_uuid}/:
    get:
      tags:
        - Webhook
      summary: webhook गंतव्य प्राप्त करें
      description: >-
        एक webhook गंतव्य को उसके `secret_shared_key` साइनिंग सीक्रेट, उसकी
        स्थिति (`health_status`, `failing_streak`, `failing_since`,
        `last_success_at`) और पिछले 30 दिनों के लिए डिलीवरी `summary` के साथ
        प्राप्त करें। API-कुंजी कॉलर्स को हमेशा पूरा सीक्रेट प्राप्त होता है;
        बिना `read:webhooks` वाले कंसोल उपयोगकर्ताओं को एक खाली स्ट्रिंग दिखाई
        देती है।
      operationId: get_webhook_destination
      parameters:
        - name: destination_uuid
          in: path
          required: true
          description: गंतव्य का UUID (बनाने या सूचीबद्ध करने से लौटाया गया `uuid`)।
          schema:
            type: string
            format: uuid
          example: 11111111-2222-3333-4444-555555555555
      responses:
        '200':
          description: Webhook गंतव्य विवरण।
          content:
            application/json:
              schema:
                type: object
                properties:
                  uuid:
                    type: string
                    format: uuid
                  label:
                    type: string
                  url:
                    type: string
                    format: uri
                  enabled:
                    type: boolean
                  webhook_version:
                    type: string
                    enum:
                      - v1
                      - v2
                      - v3
                  secret_shared_key:
                    type: string
                    description: >-
                      HMAC साइनिंग सीक्रेट (43-वर्णों वाला URL-सुरक्षित token)।
                      API-कुंजी कॉल करने वालों को हमेशा पूरा लौटाया जाता है;
                      कंसोल उपयोगकर्ताओं को `read:webhooks` की आवश्यकता होती है,
                      अन्यथा एक खाली स्ट्रिंग।
                  secret_last4:
                    type: string
                    description: >-
                      गंतव्य के वर्तमान साइनिंग सीक्रेट के अंतिम चार वर्ण, ताकि
                      आप सीक्रेट में अंतर कर सकें। हस्ताक्षर सत्यापित करने के
                      लिए पर्याप्त नहीं है।
                  previous_secret_expires_at:
                    type: string
                    format: date-time
                    nullable: true
                    description: >-
                      Business Console में गंतव्य के साइनिंग सीक्रेट को रोटेट
                      किए जाने के बाद 24 घंटों के लिए सेट होता है। इस समय तक,
                      गंतव्य पर प्रत्येक डिलीवरी में बदले गए सीक्रेट के साथ बनाए
                      गए `X-Signature-Previous`, `X-Signature-V2-Previous` और
                      `X-Signature-Simple-Previous` भी शामिल होते हैं
                      ([हस्ताक्षर
                      सत्यापन](/hi/integration/webhooks#हस्ताक्षर-सत्यापन)
                      देखें)। पिछले 24 घंटों में कोई रोटेशन न होने पर `null`।
                  subscribed_events:
                    $ref: '#/components/schemas/WebhookSubscribedEvents'
                  created_by_email:
                    type: string
                    nullable: true
                    description: >-
                      उस Business Console सदस्य का ईमेल जिसने गंतव्य बनाया। API
                      कुंजी से बनाए गए गंतव्य के लिए `null`।
                  created_by_name:
                    type: string
                    nullable: true
                    description: >-
                      Business Console के उस सदस्य का नाम जिसने गंतव्य बनाया।
                      API कुंजी से बनाए गए गंतव्य के लिए `null`।
                  created_at:
                    type: string
                    format: date-time
                  updated_at:
                    type: string
                    format: date-time
                  health_status:
                    type: string
                    enum:
                      - healthy
                      - degraded
                      - failing
                    description: >-
                      डिलीवरी स्थिति। `failing`: गंतव्य द्वारा पिछली बार
                      सफलतापूर्वक उत्तर दिए जाने के बाद से 3 या अधिक लगातार
                      इवेंट अपने पहले डिलीवरी प्रयास में विफल रहे (देखें
                      `failing_streak`)। `degraded`: failing नहीं है, लेकिन
                      पिछले 24 घंटों में एक डिलीवरी प्रयास विफल रहा और बाद के
                      किसी भी प्रयास ने उस इवेंट को डिलीवर नहीं किया है; इसे
                      डिलीवर करने वाला पुनः प्रयास या पुनः भेजना इसे साफ़ कर
                      देता है। `healthy`: दोनों में से कोई नहीं। `enabled` से
                      स्वतंत्र। एक विफल प्रयास वह होता है जिसका उत्तर HTTP 400
                      या उससे ऊपर के साथ दिया गया हो, या कोई उत्तर न दिया गया
                      हो।
                  failing_streak:
                    type: integer
                    description: >-
                      पिछले 30 दिनों के भीतर, गंतव्य द्वारा पिछली बार
                      सफलतापूर्वक उत्तर देने के बाद से कितने लगातार इवेंट अपने
                      पहले डिलीवरी प्रयास में विफल रहे। पुनः प्रयासों की गणना
                      नहीं की जाती है, और पुनः प्रयास या पुनः भेजने सहित कोई भी
                      सफल प्रयास इस सिलसिले को समाप्त कर देता है। पिछली सफलता के
                      बाद से किसी भी इवेंट के विफल न होने पर `0`।
                  failing_since:
                    type: string
                    format: date-time
                    nullable: true
                    description: >-
                      जब वर्तमान `failing_streak` का पहला विफल प्रयास किया गया
                      था। `null` जब `failing_streak` `0` हो।
                  last_success_at:
                    type: string
                    format: date-time
                    nullable: true
                    description: >-
                      जब गंतव्य ने पिछले 30 दिनों के भीतर, 400 से कम के HTTP
                      स्थिति कोड के साथ डिलीवरी का अंतिम बार उत्तर दिया। `null`
                      यदि उसने उस अवधि में उत्तर नहीं दिया है।
                  environment:
                    type: string
                    enum:
                      - live
                      - sandbox
                    description: >-
                      उस एप्लिकेशन का एनवायरनमेंट जिसके पास गंतव्य का स्वामित्व
                      है।
                  summary:
                    type: object
                    description: >-
                      पिछले `metrics_window_days` (30) दिनों के लिए डिलीवरी
                      मेट्रिक्स। `last_delivery_at` सबसे हालिया प्रयास है, चाहे
                      वह कभी भी किया गया हो।
                    properties:
                      total_deliveries:
                        type: integer
                      failed_deliveries:
                        type: integer
                      error_rate_percentage:
                        type: integer
                      min_response_time_ms:
                        type: integer
                        nullable: true
                      avg_response_time_ms:
                        type: integer
                        nullable: true
                      max_response_time_ms:
                        type: integer
                        nullable: true
                      last_delivery_at:
                        type: string
                        format: date-time
                        nullable: true
                      metrics_window_days:
                        type: integer
                        description: >-
                          दिनों में उस विंडो की अवधि जिसे अन्य सारांश मेट्रिक्स
                          कवर करते हैं। हमेशा `30`।
              examples:
                Healthy destination:
                  value:
                    uuid: 11111111-2222-3333-4444-555555555555
                    label: Production session webhooks
                    url: https://yourapp.com/webhooks/didit
                    enabled: true
                    webhook_version: v3
                    secret_shared_key: tno2NTeRC1ZK3sBOYlBJDyEzBVENl3pQ1AcZyAW0xnQ
                    secret_last4: 0xnQ
                    previous_secret_expires_at: null
                    subscribed_events:
                      - status.updated
                      - data.updated
                    created_by_email: null
                    created_by_name: null
                    created_at: '2026-01-04T08:00:00Z'
                    updated_at: '2026-04-22T14:09:11Z'
                    health_status: healthy
                    failing_streak: 0
                    failing_since: null
                    last_success_at: '2026-05-17T09:21:18Z'
                    environment: live
                    summary:
                      total_deliveries: 12453
                      failed_deliveries: 14
                      error_rate_percentage: 0
                      min_response_time_ms: 41
                      avg_response_time_ms: 187
                      max_response_time_ms: 2103
                      last_delivery_at: '2026-05-17T09:21:18Z'
                      metrics_window_days: 30
        '403':
          description: >-
            API कुंजी अनुपलब्ध, विकृत, समाप्त हो चुकी है, या किसी भिन्न
            एप्लिकेशन के लिए स्कोप की गई है। अनुपलब्ध कुंजी `403` लौटाती है;
            गलत, निरस्त या समाप्त हो चुकी कुंजी `401` लौटाती है।
          content:
            application/json:
              examples:
                Forbidden:
                  value:
                    detail: You do not have permission to perform this action.
        '404':
          description: >-
            इस UUID वाला कोई गंतव्य मौजूद नहीं है, या यह किसी भिन्न एप्लिकेशन से
            संबंधित है, या इसे हटा दिया गया है।
          content:
            application/json:
              examples:
                Not found:
                  value:
                    detail: Webhook destination not found.
        '429':
          description: रेट लिमिट पार हो गई; थोड़ा रुकें और पुनः प्रयास करें।
          content:
            application/json:
              examples:
                Throttled:
                  value:
                    detail: Request was throttled. Expected available in 30 seconds.
      security:
        - ApiKeyAuth: []
      x-codeSamples:
        - lang: curl
          label: curl
          source: >-
            curl -X GET
            'https://verification.didit.me/v3/webhook/destinations/11111111-2222-3333-4444-555555555555/'
            \
              -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(
                "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.retrieve("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.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 client = new Didit();


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


            $result =
            $didit->webhooks->destinations->retrieve('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("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.RetrieveAsync("11111111-2222-3333-4444-555555555555");

            Console.WriteLine(JsonSerializer.Serialize(result));
components:
  schemas:
    WebhookSubscribedEvents:
      type: array
      description: >-
        इस webhook गंतव्य के लिए इवेंट फ़िल्टर। Didit केवल उन webhook को डिलीवर
        करता है जिनका इवेंट प्रकार इनमें से किसी एक मान से सटीक रूप से मेल खाता
        है — कोई वाइल्डकार्ड सब्सक्रिप्शन नहीं है। भेजे जाने पर, सूची में कम से
        कम एक मान्य इवेंट होना चाहिए (एक स्पष्ट `[]` को 400 के साथ अस्वीकार कर
        दिया जाता है); ऐसा गंतव्य जिसकी सूची खाली है (निर्माण के समय फ़ील्ड छोड़
        दिया गया) कुछ भी प्राप्त नहीं करता है। अपडेट करने पर सूची पूरी तरह से
        बदल दी जाती है, कभी मर्ज नहीं की जाती।
      minItems: 1
      uniqueItems: true
      items:
        $ref: '#/components/schemas/WebhookEvent'
      example:
        - status.updated
        - data.updated
    WebhookEvent:
      type: string
      description: >-
        समर्थित webhook इवेंट का नाम। `subscribed_events` में इन सटीक स्ट्रिंग्स
        का उपयोग करें; असमर्थित मान अस्वीकृत कर दिए जाते हैं।
      enum:
        - status.updated
        - data.updated
        - user.status.updated
        - user.data.updated
        - business.status.updated
        - business.data.updated
        - activity.created
        - transaction.created
        - transaction.status.updated
        - travel_rule.status.updated
        - workflow.compliance_changed
        - transaction_rule_suggestions.created
        - auth.signup
        - auth.login
        - auth.login_failed
        - auth.password_reset_requested
        - auth.password_reset_completed
        - auth.mfa_changed
        - auth.new_device
        - auth.account_locked
        - investigator.report.ready
        - investigator.decision.automated
        - investigator.decision.overridden
        - investigator.decision.contested
        - investigator.question.raised
        - investigator.automation.paused
        - investigator.rfi.answered
        - investigator.rfi.overdue
        - investigator.drift.detected
        - investigator.sla.breached
        - investigator.qa.failed
        - investigator.external.report.ready
  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.