> ## 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 के सभी webhook गंतव्य उनके वर्शन, सब्सक्राइब किए गए इवेंट, 30-day डिलीवरी मेट्रिक्स और स्थिति सहित पाएँ। प्रति कॉल भुगतान। webhook गंतव्य सूचीबद्ध करने के लिए API प्रॉम्प्ट प्रॉम्प्ट को क्लिपबोर्ड पर कॉपी करें \

\`List every webhook destination configured for my Didit application through the Management API.

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

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

Goal:
\- Get every webhook destination (URL, version, subscribed events, delivery health) for my application. Use this to build a back-office "Webhooks" screen or to audit which destinations are receiving which events.

Behavior:
\- Returns a JSON array (not paginated) of destinations ordered by created_at.
\- The list never includes the signing secret (secret_shared_key) and has no summary object. Each item carries secret_last4, the last four characters of the secret, so you can tell secrets apart. Read the full secret from GET /v3/webhook/destinations/{destination_uuid}/.
\- Each item carries flat delivery metrics for the last 30 days (metrics_window_days is always 30): deliveries_count, failed_deliveries_count, average_response_time_ms and error_rate_percentage. last_delivery_at is the most recent attempt.
\- daily_points has 30 entries, oldest first, one per UTC day: { date, total_deliveries, failed_deliveries }. Days without deliveries carry zeros.
\- health_status is "failing" when 3 or more consecutive events failed their first delivery attempt since the destination last answered successfully (failing_streak counts them, failing_since is when the first one failed), "degraded" when an attempt failed in the last 24 hours and no later attempt has delivered that event, and "healthy" otherwise. It does not reflect enabled.
\- last_success_at is when the destination last answered under HTTP 400 in the last 30 days (null if it has not).
\- created_by_email and created_by_name name the Business Console member who created the destination; both are null for a destination created with an API key.
\- environment is "live" or "sandbox", from the application.

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

What to read from the response:
\- uuid — destination id; use as {destination_uuid} in subsequent calls.
\- url, label, enabled — basic config.
\- webhook_version — payload schema version ("v1", "v2", or "v3"; v3 is current).
\- subscribed_events — list of event names this destination receives. There is no wildcard.
\- health_status: the signal to alert on. failing_streak and failing_since tell you how long a destination has been failing.

Failure modes:
\- 401 — missing or malformed x-api-key.
\- 403 — canonical { "detail": "You do not have permission to perform this action." } envelope.
\- 429 — rate limited; back off and retry.

Side effects: none. This is a pure read.

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

\
यहाँ पेस्ट करें ## गंतव्य की स्थिति`health_status` बताता है कि गंतव्य अपनी डिलीवरी का जवाब किस तरह देता रहा है।| मान | अर्थ | | - | - | | `failing` | गंतव्य द्वारा पिछली बार सफलतापूर्वक जवाब दिए जाने के बाद से 3 या अधिक लगातार इवेंट अपने पहले डिलीवरी प्रयास में विफल रहे हैं। `failing_streak` उन्हें गिनता है और `failing_since` वह समय है जब पहला इवेंट विफल हुआ। | | `degraded` | विफल नहीं है, लेकिन पिछले 24 घंटों में एक डिलीवरी प्रयास विफल हुआ है और किसी बाद के प्रयास ने उस इवेंट को डिलीवर नहीं किया है। इसे डिलीवर करने वाला पुनः प्रयास या पुनः भेजना इस स्थिति को समाप्त कर देता है। | | `healthy` | ऊपर दोनों में से कोई भी स्थिति नहीं। |विफल प्रयास वह है जिसमें गंतव्य ने HTTP 400 या उससे अधिक के साथ जवाब दिया, या जिसका उसने बिल्कुल जवाब नहीं दिया (टाइमआउट, अस्वीकार किया गया कनेक्शन या ब्लॉक किया गया पता)। पुनः प्रयास `failing_streak` में नहीं जुड़ते, और कोई भी सफल प्रयास, जिसमें पुनः प्रयास या पुनः भेजना भी शामिल है, स्ट्रीक को समाप्त कर देता है। `health_status`, `enabled` पर निर्भर नहीं करता।डिलीवरी मेट्रिक्स और `daily_points` पिछले 30 दिनों को शामिल करते हैं (`metrics_window_days`)। `daily_points` में हमेशा 30 प्रविष्टियाँ होती हैं, हर UTC दिन के लिए एक, सबसे पुरानी पहले।## संबंधित- [webhook गंतव्य प्राप्त करें](https://docs.didit.me/hi/management-api/webhook/get-destination.md): एक गंतव्य को उसके साइनिंग सीक्रेट और डिलीवरी सारांश के साथ पढ़ें। - [Webhooks गाइड](https://docs.didit.me/hi/integration/webhooks.md): हस्ताक्षर सत्यापन, पुनः प्रयास और payload। ## OpenAPI ````yaml hi/openapi-25.json GET /v3/webhook/destinations/ 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/: get: tags: - Webhook summary: webhook गंतव्य सूचीबद्ध करें description: >- सभी webhook गंतव्य सूचीबद्ध करें (अनपेजिनेटेड ऐरे, सबसे पुराने पहले)। प्रत्येक आइटम में गंतव्य का कॉन्फ़िगरेशन, पिछले 30 दिनों (`metrics_window_days`) के लिए उसके डिलीवरी मेट्रिक्स (प्रति दिन एक `daily_points` प्रविष्टि के साथ), और उसकी स्थिति (`health_status`, `failing_streak`, `failing_since`, `last_success_at`) शामिल होती है। सूची में कोई `summary` ऑब्जेक्ट नहीं होता है और इसमें हस्ताक्षर सीक्रेट कभी शामिल नहीं होता है: प्रत्येक आइटम केवल `secret_last4` दिखाता है। `secret_shared_key` पढ़ने के लिए एक एकल गंतव्य (`GET /v3/webhook/destinations/{destination_uuid}/`) प्राप्त करें। operationId: list_webhook_destinations responses: '200': description: webhook गंतव्यों की सूची (पेजिनेशन रहित, सबसे पुराने पहले)। content: application/json: schema: type: array items: type: object properties: uuid: type: string format: uuid description: >- स्थिर गंतव्य पहचानकर्ता; अपडेट/डिलीट के लिए `{destination_uuid}` के रूप में उपयोग करें। label: type: string description: Console में दिखाया गया मानव-पठनीय नाम। url: type: string format: uri description: >- गंतव्य URL जो webhook payload के साथ `POST` अनुरोध प्राप्त करता है। enabled: type: boolean description: >- `false` होने पर, Didit इस गंतव्य पर डिलीवरी को बिना किसी सूचना के छोड़ देता है। webhook_version: type: string enum: - v1 - v2 - v3 description: >- इस गंतव्य पर भेजा गया payload स्कीमा संस्करण। `v3` वर्तमान/अनुशंसित फ़ॉर्मेट है। subscribed_events: $ref: '#/components/schemas/WebhookSubscribedEvents' subscribed_events_count: type: integer description: >- `subscribed_events` की कैश्ड लंबाई, UI रेंडरिंग के लिए उपयोगी। deliveries_count: type: integer description: >- पिछले 30 दिनों में इस गंतव्य पर किए गए डिलीवरी प्रयास (पुनः प्रयास शामिल)। failed_deliveries_count: type: integer description: >- पिछले 30 दिनों में डिलीवरी प्रयास जिन पर गंतव्य ने HTTP 400 या उससे अधिक के साथ उत्तर दिया, या उत्तर नहीं दिया (टाइमआउट, अस्वीकृत कनेक्शन या ब्लॉक किया गया पता)। average_response_time_ms: type: integer nullable: true description: >- पिछले 30 दिनों में मिलीसेकंड में औसत रिस्पॉन्स समय, जिसे निकटतम पूर्णांक तक राउंड किया गया है। उस विंडो में कोई डिलीवरी न होने पर `null`। error_rate_percentage: type: integer description: >- पिछले 30 दिनों में `round(failed_deliveries_count / deliveries_count * 100)`; जब कोई डिलीवरी न हो तो `0`। last_delivery_at: type: string format: date-time nullable: true description: >- सबसे हाल के डिलीवरी प्रयास का टाइमस्टैम्प (सफलता या विफलता)। कभी डिलीवर न होने पर `null`। metrics_window_days: type: integer description: >- दिनों में उस विंडो की अवधि जिसे `deliveries_count`, `failed_deliveries_count`, `average_response_time_ms`, `error_rate_percentage` और `daily_points` कवर करते हैं। हमेशा `30`। 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: >- उस एप्लिकेशन का एनवायरनमेंट जिसके पास गंतव्य का स्वामित्व है। daily_points: type: array description: >- पिछले 30 दिनों के प्रति UTC दिन एक प्रविष्टि, सबसे पुरानी पहले, जिसमें बिना किसी डिलीवरी वाले दिन भी शामिल हैं। पुनः प्रयास सहित प्रत्येक प्रयास की गणना करता है। items: type: object properties: date: type: string format: date description: UTC दिन। total_deliveries: type: integer description: उस दिन किए गए डिलीवरी प्रयास। failed_deliveries: type: integer description: >- उस दिन किए गए ऐसे प्रयास जिनका उत्तर HTTP 400 या उससे अधिक के साथ दिया गया था, या जिनका बिल्कुल भी उत्तर नहीं दिया गया था। secret_last4: type: string description: >- गंतव्य के वर्तमान साइनिंग सीक्रेट के अंतिम चार वर्ण, ताकि आप सीक्रेट में अंतर कर सकें। हस्ताक्षर सत्यापित करने के लिए पर्याप्त नहीं है। 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 examples: Two destinations: value: - uuid: 11111111-2222-3333-4444-555555555555 label: Production session webhooks url: https://yourapp.com/webhooks/didit enabled: true webhook_version: v3 subscribed_events: - status.updated - data.updated subscribed_events_count: 2 deliveries_count: 12453 failed_deliveries_count: 14 average_response_time_ms: 187 error_rate_percentage: 0 last_delivery_at: '2026-05-17T09:21:18Z' metrics_window_days: 30 health_status: healthy failing_streak: 0 failing_since: null last_success_at: '2026-05-17T09:21:18Z' environment: live daily_points: - date: '2026-04-18' total_deliveries: 415 failed_deliveries: 0 - date: '2026-04-19' total_deliveries: 415 failed_deliveries: 0 - date: '2026-04-20' total_deliveries: 415 failed_deliveries: 0 - date: '2026-04-21' total_deliveries: 415 failed_deliveries: 0 - date: '2026-04-22' total_deliveries: 415 failed_deliveries: 0 - date: '2026-04-23' total_deliveries: 415 failed_deliveries: 0 - date: '2026-04-24' total_deliveries: 415 failed_deliveries: 9 - date: '2026-04-25' total_deliveries: 415 failed_deliveries: 0 - date: '2026-04-26' total_deliveries: 415 failed_deliveries: 0 - date: '2026-04-27' total_deliveries: 415 failed_deliveries: 0 - date: '2026-04-28' total_deliveries: 415 failed_deliveries: 0 - date: '2026-04-29' total_deliveries: 415 failed_deliveries: 0 - date: '2026-04-30' total_deliveries: 415 failed_deliveries: 0 - date: '2026-05-01' total_deliveries: 415 failed_deliveries: 0 - date: '2026-05-02' total_deliveries: 415 failed_deliveries: 0 - date: '2026-05-03' total_deliveries: 415 failed_deliveries: 0 - date: '2026-05-04' total_deliveries: 415 failed_deliveries: 0 - date: '2026-05-05' total_deliveries: 415 failed_deliveries: 0 - date: '2026-05-06' total_deliveries: 415 failed_deliveries: 0 - date: '2026-05-07' total_deliveries: 415 failed_deliveries: 0 - date: '2026-05-08' total_deliveries: 415 failed_deliveries: 0 - date: '2026-05-09' total_deliveries: 415 failed_deliveries: 5 - date: '2026-05-10' total_deliveries: 415 failed_deliveries: 0 - date: '2026-05-11' total_deliveries: 415 failed_deliveries: 0 - date: '2026-05-12' total_deliveries: 415 failed_deliveries: 0 - date: '2026-05-13' total_deliveries: 415 failed_deliveries: 0 - date: '2026-05-14' total_deliveries: 415 failed_deliveries: 0 - date: '2026-05-15' total_deliveries: 416 failed_deliveries: 0 - date: '2026-05-16' total_deliveries: 416 failed_deliveries: 0 - date: '2026-05-17' total_deliveries: 416 failed_deliveries: 0 secret_last4: 0xnQ created_by_email: null created_by_name: null created_at: '2026-01-04T08:00:00Z' updated_at: '2026-04-22T14:09:11Z' - uuid: 22222222-3333-4444-5555-666666666666 label: Staging mirror url: https://staging.yourapp.com/webhooks/didit enabled: false webhook_version: v3 subscribed_events: - status.updated subscribed_events_count: 1 deliveries_count: 0 failed_deliveries_count: 0 average_response_time_ms: null error_rate_percentage: 0 last_delivery_at: null metrics_window_days: 30 health_status: healthy failing_streak: 0 failing_since: null last_success_at: null environment: live daily_points: - date: '2026-04-18' total_deliveries: 0 failed_deliveries: 0 - date: '2026-04-19' total_deliveries: 0 failed_deliveries: 0 - date: '2026-04-20' total_deliveries: 0 failed_deliveries: 0 - date: '2026-04-21' total_deliveries: 0 failed_deliveries: 0 - date: '2026-04-22' total_deliveries: 0 failed_deliveries: 0 - date: '2026-04-23' total_deliveries: 0 failed_deliveries: 0 - date: '2026-04-24' total_deliveries: 0 failed_deliveries: 0 - date: '2026-04-25' total_deliveries: 0 failed_deliveries: 0 - date: '2026-04-26' total_deliveries: 0 failed_deliveries: 0 - date: '2026-04-27' total_deliveries: 0 failed_deliveries: 0 - date: '2026-04-28' total_deliveries: 0 failed_deliveries: 0 - date: '2026-04-29' total_deliveries: 0 failed_deliveries: 0 - date: '2026-04-30' total_deliveries: 0 failed_deliveries: 0 - date: '2026-05-01' total_deliveries: 0 failed_deliveries: 0 - date: '2026-05-02' total_deliveries: 0 failed_deliveries: 0 - date: '2026-05-03' total_deliveries: 0 failed_deliveries: 0 - date: '2026-05-04' total_deliveries: 0 failed_deliveries: 0 - date: '2026-05-05' total_deliveries: 0 failed_deliveries: 0 - date: '2026-05-06' total_deliveries: 0 failed_deliveries: 0 - date: '2026-05-07' total_deliveries: 0 failed_deliveries: 0 - date: '2026-05-08' total_deliveries: 0 failed_deliveries: 0 - date: '2026-05-09' total_deliveries: 0 failed_deliveries: 0 - date: '2026-05-10' total_deliveries: 0 failed_deliveries: 0 - date: '2026-05-11' total_deliveries: 0 failed_deliveries: 0 - date: '2026-05-12' total_deliveries: 0 failed_deliveries: 0 - date: '2026-05-13' total_deliveries: 0 failed_deliveries: 0 - date: '2026-05-14' total_deliveries: 0 failed_deliveries: 0 - date: '2026-05-15' total_deliveries: 0 failed_deliveries: 0 - date: '2026-05-16' total_deliveries: 0 failed_deliveries: 0 - date: '2026-05-17' total_deliveries: 0 failed_deliveries: 0 secret_last4: k9Qe created_by_email: reviewer@example.com created_by_name: Example Reviewer created_at: '2026-03-12T10:15:02Z' updated_at: '2026-03-12T10:15:02Z' '403': description: >- API कुंजी अनुपलब्ध, विकृत, समाप्त हो चुकी है, या किसी भिन्न एप्लिकेशन के लिए स्कोप की गई है। अनुपलब्ध कुंजी `403` लौटाती है; गलत, निरस्त या समाप्त हो चुकी कुंजी `401` लौटाती है। content: application/json: examples: Forbidden: value: detail: You do not have permission to perform this action. '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/' \ -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.list() 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.list(); 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.List(ctx)\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().list(); System.out.println(result); - lang: php label: PHP source: |- webhooks->destinations->list(); print_r($result->toArray()); - lang: ruby label: Ruby source: |- require "didit" # Reads DIDIT_API_KEY. didit = Didit::Client.new didit.webhooks.destinations.list.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. using var client = new DiditClient(); var result = await client.Webhooks.Destinations.ListAsync(); 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.