> ## 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. # 웹훅 대상 목록 조회 API > Didit의 모든 웹훅 대상을 웹훅 버전, 구독 이벤트, 30일 전송 지표 및 상태와 함께 조회합니다. 호출당 과금. 웹훅 대상 목록 API 프롬프트 프롬프트를 클립보드에 복사 \

\`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 날짜별로 하나씩 가장 오래된 날짜부터 정렬됩니다.## 관련 문서- [웹훅 대상 조회](https://docs.didit.me/ko/management-api/webhook/get-destination.md): 서명 비밀과 전송 요약을 포함해 대상 하나를 조회합니다. - [웹훅 가이드](https://docs.didit.me/ko/integration/webhooks.md): 서명 검증, 재시도, payload를 다룹니다. ## OpenAPI ````yaml ko/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`만 표시됩니다. `secret_shared_key`를 확인하려면 단일 대상(`GET /v3/webhook/destinations/{destination_uuid}/`)을 조회하십시오. 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: 콘솔에 표시되는 사람이 읽기 쉬운 이름입니다. url: type: string format: uri description: webhook payload가 포함된 `POST` 요청을 수신하는 대상 URL입니다. 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: UI 렌더링에 유용한 `subscribed_events`의 캐시된 길이입니다. 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: >- 지난 30일간의 `round(failed_deliveries_count / deliveries_count * 100)`; 전송 내역이 없으면 `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`의 첫 번째 실패 시도가 발생한 시점입니다. `failing_streak`가 `0`인 경우 `null`입니다. last_success_at: type: string format: date-time nullable: true description: >- 최근 30일 이내에 대상이 400 미만의 HTTP 상태로 전송에 마지막으로 응답한 시점입니다. 해당 기간 내에 응답이 없었던 경우 `null`입니다. environment: type: string enum: - live - sandbox description: 대상을 소유한 애플리케이션의 환경. daily_points: type: array description: >- 전송이 없었던 날을 포함하여 지난 30일 동안의 UTC 일자당 항목 1개(가장 오래된 항목부터 정렬)입니다. 재시도를 포함한 모든 시도 횟수를 집계합니다. 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: >- 대상의 현재 서명 비밀의 마지막 4자로, 비밀을 서로 구분할 수 있습니다. 서명 검증에는 충분하지 않습니다. created_by_email: type: string nullable: true description: >- 대상을 생성한 Business Console 멤버의 이메일입니다. API 키로 생성된 대상의 경우 `null`입니다. created_by_name: type: string nullable: true description: >- 대상을 생성한 Business Console 멤버의 이름입니다. API 키로 생성된 대상의 경우 `null`입니다. 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: >- Business Console의 Developers -> API keys에서 발급받은 귀하 애플리케이션의 API 키입니다. 기본 키는 전체 접근 권한을 갖습니다. 이름이 지정된 키는 리소스별 none, read, write 범위로 권한을 제한할 수 있으며 특정 워크플로나 승인된 세션, IP 주소 목록, 만료일 등으로 제한할 수도 있습니다. 401은 키가 잘못되었거나 폐기되었거나 만료되었음을 의미합니다. 403은 키가 전송되지 않았거나, 키에 해당 리소스나 작업에 대한 접근 권한이 없거나, 요청이 허용된 IP 목록 외부 주소에서 발생했음을 의미합니다. 세션 경로에서의 404는 해당 세션이 키의 허용 워크플로 또는 상태 범위를 벗어났음을 의미합니다. 미디어 접근 권한이 없는 키는 이미지, 비디오, PDF URL을 null로 수신하며, 세션 write 권한이 없는 키는 세션 링크와 token을 null로 수신합니다. https://docs.didit.me/console/api-keys 를 참고하십시오. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.