> ## 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-Ziele auflisten: Management API > Rufen Sie alle Didit Webhook-Ziele mit Webhook-Version, abonnierten Ereignissen, 30-Tage-Metriken und Status ab. Pay-per-call. Prompt für die API zum Auflisten von Webhook-Zielen Prompt in die Zwischenablage kopieren \

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

\
Einfügen in ## Status des Ziels`health_status` fasst zusammen, wie ein Ziel auf seine Zustellungen reagiert hat.| Wert | Bedeutung | | - | - | | `failing` | 3 oder mehr aufeinanderfolgende Ereignisse sind bei ihrem ersten Zustellungsversuch fehlgeschlagen, seit das Ziel zuletzt erfolgreich geantwortet hat. `failing_streak` zählt sie, und `failing_since` gibt an, wann der erste davon fehlgeschlagen ist. | | `degraded` | Nicht im Fehlerzustand, aber ein Zustellungsversuch ist in den letzten 24 Stunden fehlgeschlagen, und kein späterer Versuch hat dieses Ereignis zugestellt. Ein Wiederholungsversuch oder ein erneutes Senden, das es zustellt, hebt diesen Status auf. | | `healthy` | Keiner der beiden oben genannten Fälle trifft zu. |Ein fehlgeschlagener Versuch liegt vor, wenn das Ziel mit HTTP 400 oder höher geantwortet hat oder gar nicht geantwortet hat (Timeout, abgelehnte Verbindung oder blockierte Adresse). Wiederholungsversuche erhöhen `failing_streak` nicht. Jeder erfolgreiche Versuch, auch ein Wiederholungsversuch oder ein erneutes Senden, beendet die Serie. `health_status` ist unabhängig von `enabled`.Die Zustellungsmetriken und `daily_points` decken die letzten 30 Tage ab (`metrics_window_days`). `daily_points` enthält immer 30 Einträge, einen pro UTC-Tag, beginnend mit dem ältesten.## Verwandte Themen- [Webhook-Ziel abrufen](https://docs.didit.me/de/management-api/webhook/get-destination.md): ein Ziel mit seinem Signaturgeheimnis und der Zustellungsübersicht abrufen. - [Webhook-Leitfaden](https://docs.didit.me/de/integration/webhooks.md): Signaturprüfung, Wiederholungsversuche und Payloads. ## OpenAPI ````yaml de/openapi-25.json GET /v3/webhook/destinations/ openapi: 3.0.0 info: version: 3.0.0 title: Didit Verification API description: API für Ausweisverifizierung. Authentifizierung über den x-api-key-Header. servers: - url: https://verification.didit.me security: [] tags: [] paths: /v3/webhook/destinations/: get: tags: - Webhook summary: Webhook-Ziele auflisten description: >- Alle Webhook-Ziele auflisten (unpaginiertes Array, älteste zuerst). Jeder Eintrag enthält die Konfiguration des Ziels, dessen Zustellungsmetriken für die letzten 30 Tage (`metrics_window_days`) mit einem `daily_points`-Eintrag pro Tag sowie dessen Status (`health_status`, `failing_streak`, `failing_since`, `last_success_at`). Die Liste hat kein `summary`-Objekt und enthält niemals das Signaturgeheimnis: Jeder Eintrag zeigt nur `secret_last4`. Rufen Sie ein einzelnes Ziel ab (`GET /v3/webhook/destinations/{destination_uuid}/`), um `secret_shared_key` auszulesen. operationId: list_webhook_destinations responses: '200': description: Liste der Webhook-Ziele (nicht paginiert, älteste zuerst). content: application/json: schema: type: array items: type: object properties: uuid: type: string format: uuid description: >- Stabiler Ziel-Identifikator; als `{destination_uuid}` für Aktualisierung/Löschung verwenden. label: type: string description: Lesbarer Name, der in der Console angezeigt wird. url: type: string format: uri description: >- Ziel-URL, die `POST`-Anfragen mit der Webhook-Payload empfängt. enabled: type: boolean description: >- Wenn `false`, überspringt Didit die Zustellung an dieses Ziel stillschweigend. webhook_version: type: string enum: - v1 - v2 - v3 description: >- Payload-Schema-Version, die an dieses Ziel gesendet wird. `v3` ist das aktuelle/empfohlene Format. subscribed_events: $ref: '#/components/schemas/WebhookSubscribedEvents' subscribed_events_count: type: integer description: >- Gecachte Länge von `subscribed_events`, nützlich für das Rendern der Benutzeroberfläche. deliveries_count: type: integer description: >- Zustellungsversuche (einschließlich Wiederholungsversuche), die in den letzten 30 Tagen an dieses Ziel gesendet wurden. failed_deliveries_count: type: integer description: >- Zustellungsversuche in den letzten 30 Tagen, die das Ziel mit HTTP 400 oder höher beantwortet hat oder die unbeantwortet blieben (Timeout, abgelehnte Verbindung oder blockierte Adresse). average_response_time_ms: type: integer nullable: true description: >- Durchschnittliche Antwortzeit in Millisekunden über die letzten 30 Tage, gerundet auf eine Ganzzahl. `null`, wenn in diesem Zeitraum keine Zustellungen stattfanden. error_rate_percentage: type: integer description: >- `round(failed_deliveries_count / deliveries_count * 100)` über die letzten 30 Tage; `0`, wenn keine Zustellungen vorliegen. last_delivery_at: type: string format: date-time nullable: true description: >- Zeitstempel des letzten Zustellungsversuchs (Erfolg oder Fehlschlag). `null`, falls nie zugestellt. metrics_window_days: type: integer description: >- Länge des Zeitfensters in Tagen, das von `deliveries_count`, `failed_deliveries_count`, `average_response_time_ms`, `error_rate_percentage` und `daily_points` abgedeckt wird. Immer `30`. health_status: type: string enum: - healthy - degraded - failing description: >- Zustellungsstatus. `failing`: Bei 3 oder mehr aufeinanderfolgenden Ereignissen ist jeweils der erste Zustellversuch fehlgeschlagen, seit das Ziel zuletzt erfolgreich geantwortet hat (siehe `failing_streak`). `degraded`: nicht failing, aber in den letzten 24 Stunden ist ein Zustellversuch fehlgeschlagen und kein späterer Versuch hat dieses Ereignis zugestellt; ein Wiederholungsversuch oder ein erneutes Senden, das es zustellt, hebt dies auf. `healthy`: weder noch. Unabhängig von `enabled`. Ein fehlgeschlagener Versuch ist ein Versuch, der mit HTTP 400 oder höher beantwortet oder überhaupt nicht beantwortet wurde. failing_streak: type: integer description: >- Wie viele aufeinanderfolgende Ereignisse bei ihrem ersten Zustellversuch fehlgeschlagen sind, seit das Ziel innerhalb der letzten 30 Tage zuletzt erfolgreich geantwortet hat. Wiederholungsversuche werden nicht gezählt, und jeder erfolgreiche Versuch, einschließlich eines Wiederholungsversuchs oder eines erneuten Sendens, beendet die Serie. `0`, wenn seit dem letzten Erfolg kein Ereignis fehlgeschlagen ist. failing_since: type: string format: date-time nullable: true description: >- Wann der erste fehlgeschlagene Versuch der aktuellen `failing_streak` unternommen wurde. `null`, wenn `failing_streak` den Wert `0` hat. last_success_at: type: string format: date-time nullable: true description: >- Wann das Ziel zuletzt innerhalb der letzten 30 Tage auf eine Zustellung mit einem HTTP-Status unter 400 geantwortet hat. `null`, wenn dies in diesem Zeitfenster nicht der Fall war. environment: type: string enum: - live - sandbox description: Umgebung der Anwendung, zu der das Ziel gehört. daily_points: type: array description: >- Ein Eintrag pro UTC-Tag der letzten 30 Tage, älteste zuerst, einschließlich Tagen ohne Zustellungen. Zählt jeden Versuch, einschließlich Wiederholungsversuchen. items: type: object properties: date: type: string format: date description: Der UTC-Tag. total_deliveries: type: integer description: An diesem Tag unternommene Zustellversuche. failed_deliveries: type: integer description: >- Versuche an diesem Tag, die mit HTTP 400 oder höher oder gar nicht beantwortet wurden. secret_last4: type: string description: >- Die letzten vier Zeichen des aktuellen Signiergeheimnisses des Ziels, damit Sie Geheimnisse voneinander unterscheiden können. Reicht nicht aus, um eine Signatur zu verifizieren. created_by_email: type: string nullable: true description: >- E-Mail des Mitglieds der Business Console, das das Ziel erstellt hat. `null` für ein mit einem API-Schlüssel erstelltes Ziel. created_by_name: type: string nullable: true description: >- Name des Mitglieds der Business Console, das das Ziel erstellt hat. `null` bei einem Ziel, das mit einem API-Schlüssel erstellt wurde. 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-Schlüssel fehlt, ist fehlerhaft, abgelaufen oder für eine andere Anwendung gültig. Ein fehlender Schlüssel gibt `403` zurück; ein falscher, widerrufener oder abgelaufener Schlüssel gibt `401` zurück. content: application/json: examples: Forbidden: value: detail: You do not have permission to perform this action. '429': description: >- Rate-Limit überschritten; drosseln Sie die Anfragen und wiederholen Sie den Versuch. 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: >- Ereignisfilter für dieses Webhook-Ziel. Didit stellt nur Webhooks zu, deren Ereignistyp exakt mit einem dieser Werte übereinstimmt – es gibt kein Wildcard-Abonnement. Beim Senden muss die Liste mindestens ein gültiges Ereignis enthalten (ein explizites `[]` wird mit 400 abgelehnt); ein Ziel mit leerer Liste (Feld bei der Erstellung weggelassen) empfängt nichts. Bei einer Aktualisierung wird die Liste vollständig ersetzt, niemals zusammengeführt. minItems: 1 uniqueItems: true items: $ref: '#/components/schemas/WebhookEvent' example: - status.updated - data.updated WebhookEvent: type: string description: >- Name des unterstützten Webhook-Ereignisses. Verwenden Sie genau diese Zeichenfolgen in `subscribed_events`; nicht unterstützte Werte werden abgelehnt. 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: >- Der API-Schlüssel Ihrer Anwendung, aus Entwickler -> API-Schlüssel in der Business Console. Der Primärschlüssel hat Vollzugriff. Ein benannter Schlüssel kann im Geltungsbereich eingeschränkt werden: keine, Lese- oder Schreibberechtigung pro Ressource, beschränkt auf bestimmte Workflows oder genehmigte Sitzungen, auf eine Liste von IP-Adressen und auf ein Ablaufdatum. 401 bedeutet, dass der Schlüssel falsch, widerrufen oder abgelaufen ist; 403 bedeutet, dass kein Schlüssel gesendet wurde, der Schlüssel keinen Zugriff auf diese Ressource oder Aktion hat oder die Anfrage von einer Adresse außerhalb seiner IP-Liste stammte; 404 bei einer Sitzungsroute bedeutet, dass die Sitzung außerhalb der Workflows oder Status des Schlüssels liegt. Ein Schlüssel ohne Medienzugriff erhält Bild-, Video- und PDF-URLs als null, und ein Schlüssel ohne Schreibberechtigung für Sitzungen erhält Sitzungslinks und Token als null. Siehe https://docs.didit.me/console/api-keys. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.