> ## 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. # Analytics destinazione webhook API > Didit: totali di consegna, tasso di errore e tempi di risposta di una destinazione webhook, per giorno UTC e per qualsiasi intervallo di date. Prompt API per ottenere le analisi della destinazione webhook Copia il prompt negli appunti \

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

\
Incolla in Usa questo endpoint per monitorare una destinazione webhook per un periodo a tua scelta. Per vedere i singoli tentativi alla base di un errore, elencali con [Elenca le consegne della destinazione webhook](https://docs.didit.me/it/management-api/webhook/list-deliveries.md) e aprine una con [Ottieni una consegna della destinazione webhook](https://docs.didit.me/it/management-api/webhook/get-delivery.md).Le risposte per le quali Didit effettua automaticamente un nuovo tentativo sono descritte nella [politica dei nuovi tentativi](https://docs.didit.me/it/integration/webhooks.md#politica-di-nuovo-tentativo). ## OpenAPI ````yaml it/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 di verifica dell'identità. Autenticati con l'intestazione x-api-key. servers: - url: https://verification.didit.me security: [] tags: [] paths: /v3/webhook/destinations/{destination_uuid}/analytics/: get: tags: - Webhook summary: Recupera analisi della destinazione webhook description: >- Totali di consegna, tasso di fallimento e tempi di risposta per una destinazione webhook, sull'intero intervallo (`summary`) e per giorno UTC (`points`). Ogni tentativo conta come una consegna: il primo invio di un evento, ogni [nuovo tentativo](https://docs.didit.me/it/integration/webhooks#politica-di-nuovo-tentativo) automatico e ogni reinvio. Una consegna è fallita quando lo stato HTTP registrato è 400 o superiore, quindi i timeout (registrati come `504`) e gli errori di connessione (`503`) contano come falliti; una consegna ancora in coda conta solo in `total_deliveries`. I record di consegna sono disponibili per circa 30 giorni. Una chiave API con ambito richiede `webhooks: read`. operationId: get_webhook_destination_analytics parameters: - name: destination_uuid in: path required: true description: >- UUID della destinazione (lo `uuid` restituito da `GET /v3/webhook/destinations/`). schema: type: string format: uuid example: 11111111-2222-3333-4444-555555555555 - name: date_from in: query required: false description: >- Primo giorno UTC da includere, in formato `YYYY-MM-DD` (incluso). Omettere per iniziare dalla consegna disponibile più datata. Viene accettato `dateFrom` come alias. schema: type: string format: date example: '2026-10-01' - name: date_to in: query required: false description: >- Ultimo giorno UTC da includere, nel formato `YYYY-MM-DD` (incluso). Non deve essere precedente a `date_from`. `dateTo` è accettato come alias. schema: type: string format: date example: '2026-10-16' responses: '200': description: Statistiche di consegna per la destinazione. content: application/json: schema: type: object required: - summary - points properties: summary: type: object description: Totali per l'intervallo richiesto. 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: Tentativi di consegna, inclusi quelli in coda. failed_deliveries: type: integer minimum: 0 description: >- Tentativi il cui stato HTTP registrato è 400 o superiore. min_response_time_ms: type: integer nullable: true description: >- Tentativo più rapido in millisecondi, oppure `null` se nessun tentativo ha un tempo registrato. avg_response_time_ms: type: integer nullable: true description: >- Tempo medio dei tentativi in millisecondi, arrotondato, o `null` se nessun tentativo ha un tempo registrato. max_response_time_ms: type: integer nullable: true description: >- Tentativo più lento in millisecondi, o `null` quando nessun tentativo ha un tempo registrato. error_rate_percentage: type: integer minimum: 0 maximum: 100 description: >- `failed_deliveries` / `total_deliveries` x 100, arrotondato a un numero intero. `0` quando non ci sono consegne. points: type: array description: >- Una voce per ogni giorno UTC in cui ci sono state consegne, a partire dal più vecchio. I giorni senza consegne sono omessi, quindi riempi gli intervalli con zeri quando li rappresenti in un grafico. 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: Giorno UTC, `YYYY-MM-DD`. total_deliveries: type: integer minimum: 0 description: Tentativi di consegna, inclusi quelli in coda. failed_deliveries: type: integer minimum: 0 description: >- Tentativi il cui stato HTTP registrato è 400 o superiore. min_response_time_ms: type: integer nullable: true description: >- Tentativo più rapido in millisecondi, oppure `null` se nessun tentativo ha un tempo registrato. avg_response_time_ms: type: integer nullable: true description: >- Tempo medio dei tentativi in millisecondi, arrotondato, o `null` se nessun tentativo ha un tempo registrato. max_response_time_ms: type: integer nullable: true description: >- Tentativo più lento in millisecondi, o `null` quando nessun tentativo ha un tempo registrato. 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` o `date_to` non è una data in formato `YYYY-MM-DD`, oppure `date_to` è precedente a `date_from`. content: application/json: schema: type: object description: Ciascun campo non valido associato a un elenco di messaggi. 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: >- La chiave API è scaduta: è stata creata con una data di scadenza ormai trascorsa. Anche una chiave errata o revocata riceve `401`; una chiave mancante riceve `403`. content: application/json: schema: type: object properties: detail: type: string description: Messaggio di errore di facile lettura. examples: Expired key: value: detail: This API key has expired. '403': description: >- La richiesta non è consentita. Una chiave `x-api-key` mancante, non valida o revocata restituisce `You do not have permission to perform this action.` Una chiave con ambito senza l'accesso richiesto da questo endpoint restituisce un messaggio che indica l'accesso mancante, mentre una chiave utilizzata al di fuori della sua allowlist IP restituisce `This API key can't be used from this IP address.` content: application/json: schema: type: object properties: detail: type: string description: Messaggio di errore di facile lettura. 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: >- Nessuna destinazione con questo UUID esiste per l'applicazione, oppure è stata eliminata. content: application/json: schema: type: object properties: detail: type: string description: Messaggio di errore di facile lettura. examples: Destination not found: value: detail: Webhook destination not found. '429': description: >- Limite di frequenza superato: più di 600 richieste GET nella finestra corrente di un minuto per questa chiave API. Attendi `Retry-After` secondi prima di riprovare. headers: Retry-After: description: Secondi da attendere prima di effettuare un nuovo tentativo. schema: type: integer minimum: 1 example: 30 X-RateLimit-Limit: description: Richieste consentite nell'intervallo di un minuto (600). schema: type: integer example: 600 X-RateLimit-Remaining: description: Richieste rimanenti nell'intervallo corrente. schema: type: integer example: 0 X-RateLimit-Reset: description: Ora Unix (secondi) in cui la finestra corrente si azzera. schema: type: integer example: 1792056120 X-RateLimit-Scope: description: Nome del budget superato. schema: type: string example: generic-get content: application/json: schema: type: object properties: detail: type: string description: Messaggio di errore di facile lettura. 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: >- 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: >- La chiave API della tua applicazione, da Developers -> API keys nella Business Console. La chiave primaria ha accesso completo. Una chiave con nome può avere un ambito definito: nessuno, lettura o scrittura per risorsa, limitata ad alcuni workflow o a sessioni approvate, a un elenco di indirizzi IP e a una data di scadenza. 401 indica che la chiave è errata, revocata o scaduta; 403 indica che non è stata inviata alcuna chiave, che la chiave non ha accesso a questa risorsa o azione, oppure che la richiesta proviene da un indirizzo non incluso nel suo elenco IP; 404 su una route di sessione indica che la sessione non rientra nei workflow o negli stati previsti dalla chiave. Una chiave senza accesso ai media riceve gli URL di immagini, video e PDF come null, e una chiave senza permessi di scrittura sulle sessioni riceve link e token di sessione come null. Consulta https://docs.didit.me/console/api-keys. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.