> ## 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. # Llistar destinacions de webhook: API de Didit > Obtén totes les destinacions de webhook de Didit amb versió, esdeveniments subscrits, mètriques de 30 dies i estat. Pagament per crida. Prompt de l'API per llistar les destinacions de webhook Copia el prompt al porta-retalls \

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

\
Enganxa a ## Estat de la destinació`health_status` resumeix com ha estat responent la destinació als lliuraments.| Valor | Significat | | - | - | | `failing` | 3 o més esdeveniments consecutius han fallat en el primer intent de lliurament des de l'última vegada que la destinació va respondre satisfactòriament. `failing_streak` els compta i `failing_since` és el moment en què va fallar el primer. | | `degraded` | No està fallant, però un intent de lliurament ha fallat en les últimes 24 hores i cap intent posterior no ha lliurat aquell esdeveniment. Un reintent o un reenviament que el lliuri resol aquest estat. | | `healthy` | Cap de les anteriors. |Un intent fallit és aquell al qual la destinació ha respost amb HTTP 400 o superior, o al qual no ha respost en absolut (temps d'espera, connexió rebutjada o adreça bloquejada). Els reintents no s'afegeixen a `failing_streak`, i qualsevol intent satisfactori, inclosos un reintent o un reenviament, posa fi a la ratxa. `health_status` és independent de `enabled`.Les mètriques de lliurament i `daily_points` cobreixen els últims 30 dies (`metrics_window_days`). `daily_points` té sempre 30 entrades, una per dia UTC, de la més antiga a la més recent.## Relacionat- [Obtén una destinació de webhook](https://docs.didit.me/ca/management-api/webhook/get-destination.md): llegeix una destinació amb el seu secret de signatura i el resum de lliuraments. - [Guia de webhooks](https://docs.didit.me/ca/integration/webhooks.md): verificació de la signatura, reintents i payloads. ## OpenAPI ````yaml ca/openapi-25.json GET /v3/webhook/destinations/ 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/: get: tags: - Webhook summary: Llista les destinacions del webhook description: >- Llista totes les destinacions del webhook (array no paginat, les més antigues primer). Cada element conté la configuració de la destinació, les seves mètriques de lliurament dels darrers 30 dies (`metrics_window_days`) amb una entrada `daily_points` per dia, i el seu estat (`health_status`, `failing_streak`, `failing_since`, `last_success_at`). La llista no té cap objecte `summary` i mai no inclou el secret de signatura: cada element mostra només `secret_last4`. Obtén una única destinació (`GET /v3/webhook/destinations/{destination_uuid}/`) per llegir `secret_shared_key`. operationId: list_webhook_destinations responses: '200': description: >- Llista de destinacions del webhook (sense paginar, les més antigues primer). content: application/json: schema: type: array items: type: object properties: uuid: type: string format: uuid description: >- Identificador de destinació estable; utilitza'l com a `{destination_uuid}` per actualitzar o eliminar. label: type: string description: Nom fàcil de llegir que es mostra a la Console. url: type: string format: uri description: >- URL de destinació que rep sol·licituds `POST` amb el payload del webhook. enabled: type: boolean description: >- Quan és `false`, Didit omet silenciosament el lliurament a aquesta destinació. webhook_version: type: string enum: - v1 - v2 - v3 description: >- Versió de l'esquema del payload enviat a aquesta destinació. `v3` és el format actual/recomanat. subscribed_events: $ref: '#/components/schemas/WebhookSubscribedEvents' subscribed_events_count: type: integer description: >- Longitud a la memòria cau de `subscribed_events`, útil per a la renderització de la interfície d'usuari. deliveries_count: type: integer description: >- Intents de lliurament (inclosos els reintents) fets a aquesta destinació en els darrers 30 dies. failed_deliveries_count: type: integer description: >- Intents de lliurament en els darrers 30 dies en què la destinació va respondre amb HTTP 400 o superior, o no va respondre (temps d'espera esgotat, connexió rebutjada o adreça bloquejada). average_response_time_ms: type: integer nullable: true description: >- Temps de resposta mitjà en mil·lisegons durant els darrers 30 dies, arrodonit a un enter. `null` quan no hi ha hagut cap lliurament en aquesta finestra. error_rate_percentage: type: integer description: >- `round(failed_deliveries_count / deliveries_count * 100)` durant els darrers 30 dies; `0` quan no hi ha lliuraments. last_delivery_at: type: string format: date-time nullable: true description: >- Marca de temps de l'intent de lliurament més recent (satisfactori o fallit). `null` si mai no s'ha lliurat. metrics_window_days: type: integer description: >- Durada en dies de la finestra que cobreixen `deliveries_count`, `failed_deliveries_count`, `average_response_time_ms`, `error_rate_percentage` i `daily_points`. Sempre és `30`. 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ó. daily_points: type: array description: >- Una entrada per dia UTC dels darrers 30 dies, el més antic primer, inclosos els dies sense lliuraments. Compta cada intent, reintents inclosos. items: type: object properties: date: type: string format: date description: El dia UTC. total_deliveries: type: integer description: Intents de lliurament fets aquell dia. failed_deliveries: type: integer description: >- Intents realitzats aquell dia als quals es va respondre amb HTTP 400 o superior, o que no es van respondre en absolut. 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. 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 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: >- 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. '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/' \ -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: >- 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.