> ## 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 > Получите все адреса назначения webhook в Didit с версией webhook, подписанными событиями, метриками доставки за 30 дней и статусом состояния. Оплата за вызов. Промпт API: список адресов назначения webhook Скопировать промпт в буфер обмена \

\`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/ru/management-api/webhook/get-destination.md): просмотр одного адреса назначения с секретом подписи и сводкой доставки. - [Руководство по webhook](https://docs.didit.me/ru/integration/webhooks.md): проверка подписи, повторные попытки и payload. ## OpenAPI ````yaml ru/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`. Запросите отдельный адрес назначения (`GET /v3/webhook/destinations/{destination_uuid}/`), чтобы прочитать `secret_shared_key`. 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 адреса назначения, принимающий `POST`-запросы с payload webhook. 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: >- `round(failed_deliveries_count / deliveries_count * 100)` за последние 30 дней; `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: >- Когда адрес назначения в последний раз ответил на доставку с HTTP-статусом ниже 400 за последние 30 дней. `null`, если ответов в этот период не было. environment: type: string enum: - live - sandbox description: Среда приложения, которому принадлежит адрес назначения. daily_points: type: array description: >- Одна запись на каждый день по UTC за последние 30 дней, начиная с самых старых, включая дни без доставок. Учитывает каждую попытку, включая повторные попытки. 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, создавшего адрес назначения. `null` для адреса назначения, созданного с помощью API-ключа. created_by_name: type: string nullable: true description: >- Имя участника Business Console, создавшего адрес назначения. `null` для адреса назначения, созданного с помощью 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: >- 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-ключ вашего приложения из раздела «Разработчикам» -> «API-ключи» в Business Console. Основной ключ имеет полный доступ. Именованный ключ может иметь ограниченную область действия: без доступа, чтение или запись для каждого ресурса, ограничение определенными сценариями или одобренными сессиями, списком IP-адресов и сроком действия. 401 означает, что ключ неверен, отозван или его срок действия истек; 403 означает, что ключ не был передан, у ключа нет доступа к этому ресурсу или действию, либо запрос поступил с адреса вне его списка IP-адресов; 404 на маршруте сессии означает, что сессия не входит в сценарии или статусы ключа. Ключ без доступа к медиа получает URL изображений, видео и PDF как null, а ключ без прав на запись сессий получает ссылки на сессии и токены как null. См. https://docs.didit.me/console/api-keys. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.