> ## 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. # Consultar una destinació de webhook: API de gestió > Obtén una destinació de webhook de Didit amb el secret compartit, els esdeveniments subscrits, l'estat i el resum de lliuraments de 30 dies. Pagament per crida. Prompt de l'API per obtenir una destinació del webhook Copia el prompt al porta-retalls \

\`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.`

\
Enganxa a La resposta inclou els mateixos camps d'estat que el [llistat](https://docs.didit.me/ca/management-api/webhook/list-destinations.md#estat-de-la-destinació), més un `summary` dels últims 30 dies.## Relacionats- [Llistar les destinacions del webhook](https://docs.didit.me/ca/management-api/webhook/list-destinations.md): totes les destinacions amb el seu estat i els recomptes diaris de lliuraments. - [Guia de webhooks](https://docs.didit.me/ca/integration/webhooks.md#verificació-de-la-signatura): com verificar les signatures, fins i tot durant una rotació del secret. ## OpenAPI ````yaml ca/openapi-25.json GET /v3/webhook/destinations/{destination_uuid}/ openapi: 3.0.0 info: version: 3.0.0 title: Didit Verification API description: API de verificació d'identitat. Autentica't amb la capçalera x-api-key. servers: - url: https://verification.didit.me security: [] tags: [] paths: /v3/webhook/destinations/{destination_uuid}/: get: tags: - Webhook summary: Obtenir la destinació del webhook description: >- Recupera una destinació de webhook amb el seu secret de signatura `secret_shared_key`, el seu estat (`health_status`, `failing_streak`, `failing_since`, `last_success_at`) i un resum de lliuraments (`summary`) dels darrers 30 dies. Les crides amb clau d'API reben sempre el secret complet; els usuaris de la consola sense `read:webhooks` veuen una cadena buida. operationId: get_webhook_destination parameters: - name: destination_uuid in: path required: true description: UUID de la destinació (el `uuid` retornat en crear o llistar). schema: type: string format: uuid example: 11111111-2222-3333-4444-555555555555 responses: '200': description: Detalls de la destinació del 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: >- Secret de signatura HMAC (token de 43 caràcters compatible amb URL). Sempre es retorna complet per a qui crida amb clau d'API; els usuaris de la consola necessiten `read:webhooks`, en cas contrari es retorna una cadena buida. secret_last4: type: string description: >- Últims quatre caràcters del secret de signatura actual de la destinació, perquè puguis distingir els secrets. No són suficients per verificar una signatura. previous_secret_expires_at: type: string format: date-time nullable: true description: >- Establert durant 24 hores després que el secret de signatura de la destinació es roti a la Business Console. Fins aquest moment, cada lliurament a la destinació també inclou `X-Signature-Previous`, `X-Signature-V2-Previous` i `X-Signature-Simple-Previous`, generats amb el secret substituït (consulta [Verificació de la signatura](/ca/integration/webhooks#verificació-de-la-signatura)). `null` quan no s'ha produït cap rotació en les darreres 24 hores. subscribed_events: $ref: '#/components/schemas/WebhookSubscribedEvents' created_by_email: type: string nullable: true description: >- Correu electrònic del membre de la Business Console que ha creat la destinació. `null` per a una destinació creada amb una clau d'API. created_by_name: type: string nullable: true description: >- Nom del membre de la Business Console que ha creat la destinació. `null` per a una destinació creada amb una clau d'API. created_at: type: string format: date-time updated_at: type: string format: date-time health_status: type: string enum: - healthy - degraded - failing description: >- Estat del lliurament. `failing`: 3 o més esdeveniments consecutius han fallat en el seu primer intent de lliurament des que la destinació va respondre satisfactòriament per darrera vegada (consulta `failing_streak`). `degraded`: no és failing, però un intent de lliurament ha fallat en les darreres 24 hores i cap intent posterior ha lliurat aquest esdeveniment; un reintent o reenviament que el lliuri neteja aquest estat. `healthy`: cap dels dos. Independent d'`enabled`. Un intent fallit és un que ha rebut una resposta HTTP 400 o superior, o que no ha rebut cap resposta. failing_streak: type: integer description: >- Quants esdeveniments consecutius han fallat en el seu primer intent de lliurament des que la destinació va respondre satisfactòriament per última vegada, durant els darrers 30 dies. Els reintents no es comptabilitzen, i qualsevol intent satisfactori, inclòs un reintent o un reenviament, posa fi a la ratxa. `0` quan cap esdeveniment ha fallat des de l'últim èxit. failing_since: type: string format: date-time nullable: true description: >- Quan es va fer el primer intent fallit de la `failing_streak` actual. `null` quan `failing_streak` és `0`. last_success_at: type: string format: date-time nullable: true description: >- Quan la destinació va respondre per darrera vegada a un lliurament amb un estat HTTP inferior a 400, en els darrers 30 dies. `null` si no ho ha fet en aquest interval. environment: type: string enum: - live - sandbox description: Entorn de l'aplicació propietària de la destinació. summary: type: object description: >- Mètriques de lliurament dels darrers `metrics_window_days` (30) dies. `last_delivery_at` és l'intent més recent, independentment de quan es va fer. 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: >- Durada en dies de la finestra que cobreixen les altres mètriques de resum. Sempre és `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: >- Falta la clau d'API, està mal formada, ha caducat o està assignada a una aplicació diferent. Si falta la clau es retorna `403`; una clau incorrecta, revocada o caducada retorna `401`. content: application/json: examples: Forbidden: value: detail: You do not have permission to perform this action. '404': description: >- No existeix cap destinació amb aquest UUID, pertany a una aplicació diferent o s'ha suprimit. content: application/json: examples: Not found: value: detail: Webhook destination not found. '429': description: >- S'ha superat el límit de freqüència; redueix el ritme de les sol·licituds i reintenta-ho. 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: >- 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: >- Filtre d'esdeveniments per a aquesta destinació del webhook. Didit només lliura webhooks el tipus d'esdeveniment dels quals coincideix exactament amb un d'aquests valors; no hi ha subscripció amb caràcters comodí. Quan s'envia, la llista ha de contenir almenys un esdeveniment vàlid (un `[]` explícit es rebutja amb 400); una destinació amb la llista buida (camp omès en crear-se) no rep res. En actualitzar, la llista es reemplaça completament, mai es fusiona. minItems: 1 uniqueItems: true items: $ref: '#/components/schemas/WebhookEvent' example: - status.updated - data.updated WebhookEvent: type: string description: >- Nom d'esdeveniment de webhook admès. Utilitza aquestes cadenes exactes a `subscribed_events`; els valors no admesos es rebutgen. 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: >- La clau d'API de la teva aplicació, des de Developers -> API keys a la Business Console. La clau primària té accés complet. Una clau amb nom pot tenir l'abast limitat: cap, lectura o escriptura per recurs, limitada a determinats fluxos de treball o a sessions aprovades, a una llista d'adreces IP i a una data de caducitat. 401 significa que la clau és incorrecta, revocada o caducada; 403 significa que no s'ha enviat cap clau, que la clau no té accés a aquest recurs o acció, o que la sol·licitud prové d'una adreça fora de la seva llista d'IP; 404 en una ruta de sessió significa que la sessió està fora dels fluxos de treball o estats de la clau. Una clau sense accés a fitxers multimèdia rep els URL d'imatge, vídeo i PDF com a null, i una clau sense permís d'escriptura de sessions rep els enllaços de sessió i els tokens com a null. Consulta https://docs.didit.me/console/api-keys. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.