> ## 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 > Diditが送信した正確な署名ヘッダーとJSONペイロード、およびエンドポイントが返したステータスコードを含む、Webhook配信試行1件の詳細を取得します。 Webhookの送信先の配信取得API用プロンプト プロンプトをクリップボードにコピー \

\`Read one delivery attempt made to a Didit webhook destination through the Management API.

Endpoint:
GET https://verification.didit.me/v3/webhook/destinations/{destination_uuid}/deliveries/{delivery_uuid}/

Authentication:
Use the x-api-key header with my Didit API key. A scoped API key needs webhooks: read and decisions: read. A key limited to some workflows or to approved sessions cannot use this endpoint.

Goal:
\- See exactly what Didit sent to my endpoint, to debug signature verification or payload handling.

Path parameters:
\- destination_uuid: the destination uuid from GET /v3/webhook/destinations/.
\- delivery_uuid: the uuid of an entry from GET /v3/webhook/destinations/{destination_uuid}/deliveries/.

Behavior:
\- Returns the delivery fields of the list (uuid, session_id, request_url, response_status, response_time_ms, status, webhook_type, created_at) plus request_header and request_body.
\- request_header and request_body are JSON text (strings). Parse them: request_header holds Content-Type, X-Signature, X-Signature-V2, X-Signature-Simple, X-Timestamp and User-Agent; request_body holds the event payload, including event_id.
\- A scoped key without media: read receives media URLs inside request_body as null; without sessions: write it receives session tokens and hosted verification links as null. A body changed that way is re-encoded and no longer matches the signatures.

Example call:
curl -X GET "https://verification.didit.me/v3/webhook/destinations/{destination_uuid}/deliveries/{delivery_uuid}/" \
-H "x-api-key: YOUR_API_KEY"

Failure modes:
\- 401: { "detail": "This API key has expired." }
\- 403: { "detail": "You do not have permission to perform this action." }, { "detail": "This API key has no read access to webhooks." }, { "detail": "This API key has no read access to decisions." }, or the limited-key message.
\- 404: { "detail": "Webhook destination not found." } or { "detail": "Webhook delivery not found." } (the delivery does not belong to this destination).
\- 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.`

\
貼り付け先 署名検証コードを実際の配信で確認するには、[署名検証](https://docs.didit.me/ja/integration/webhooks.md#署名検証)の説明に従い、送信先の`secret_shared_key`を使って`request_body`から`X-Signature-V2`を再計算します。この確認にはフルアクセス権限を持つキーを使用してください。値がマスクされたボディは、その署名と一致しなくなります。配信を再送するには、[Webhookの送信先の配信を再送](https://docs.didit.me/ja/management-api/webhook/resend-delivery.md)を呼び出します。 ## OpenAPI ````yaml ja/openapi-25.json GET /v3/webhook/destinations/{destination_uuid}/deliveries/{delivery_uuid}/ 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/{destination_uuid}/deliveries/{delivery_uuid}/: get: tags: - Webhook summary: Webhookの送信先の配信を取得 description: >- Webhookの送信先への1回の配信試行を取得します。Diditが送信したリクエストヘッダーとJSONボディそのもの、エンドポイントが返したHTTPステータス、レスポンス時間が含まれます。`request_header`と`request_body`はJSONテキストです。これらをパースすると署名ヘッダーとペイロードを読み取れます。たとえば、送信先の`secret_shared_key`を使って[署名検証](https://docs.didit.me/ja/integration/webhooks#署名検証)を確認できます。配信に署名シークレットが含まれることはなく、Diditはエンドポイントのレスポンスボディを記録しません。スコープ付きAPIキーには`webhooks: read`と`decisions: read`が必要です。一部のワークフローまたは承認済みセッションに限定されたキーでは、このエンドポイントを使用できません。 operationId: get_webhook_destination_delivery parameters: - name: destination_uuid in: path required: true description: 配信が送られた送信先のUUIDです。 schema: type: string format: uuid example: 11111111-2222-3333-4444-555555555555 - name: delivery_uuid in: path required: true description: >- 配信のUUIDで、`GET /v3/webhook/destinations/{destination_uuid}/deliveries/`が返すエントリーの`uuid`です。 schema: type: string format: uuid example: 66666666-7777-8888-9999-000000000001 responses: '200': description: リクエストヘッダーとボディを含む配信です。 content: application/json: schema: $ref: '#/components/schemas/WebhookDestinationDeliveryDetail' examples: Connection failure: value: uuid: 66666666-7777-8888-9999-000000000001 session_id: 22222222-3333-4444-5555-666666666666 request_url: https://yourapp.com/webhooks/didit response_status: 503 response_time_ms: 412 status: In Progress webhook_type: status.updated created_at: '2026-10-15T09:21:18.412345Z' request_header: >- {"Content-Type": "application/json", "X-Signature": "a5e02a03404e1337a0198e6be15d34abbd053c658a0e51e5d0e78554213ef29b", "X-Signature-V2": "927e7cb770c94ce745939bff73f04aa200015f3bc64795ba46c2aaf78a6cedc5", "X-Signature-Simple": "e37b0d4c716c72bb5ae7127b9cc455d28ab4686e9e22312b4ec2327409a73302", "X-Timestamp": "1792056078", "User-Agent": "DiditWebhook/2.0 +https://didit.me"} request_body: >- {"application_id":"aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee","created_at":1792056057,"environment":"live","event_id":"33333333-4444-5555-6666-777777777777","sandbox_scenario":null,"session_id":"22222222-3333-4444-5555-666666666666","status":"In Progress","timestamp":1792056078,"vendor_data":"user-123","webhook_type":"status.updated","workflow_id":"44444444-5555-6666-7777-888888888888","workflow_version":3} '401': description: >- APIキーの有効期限が切れています。有効期限を指定して作成され、その期限が過ぎています。誤ったキーや失効したキーでも`401`が返されます。キーがない場合は`403`が返されます。 content: application/json: schema: type: object properties: detail: type: string description: 人が読めるエラーメッセージ。 examples: Expired key: value: detail: This API key has expired. '403': description: >- リクエストは許可されていません。`x-api-key`がない、無効、または失効している場合は`You do not have permission to perform this action.`が返されます。このエンドポイントに必要なアクセス権を持たないスコープ付きキーの場合は、不足しているアクセス権を示すメッセージが返されます。IP許可リスト外から使用されたキーの場合は`This API key can't be used from this IP address.`が返されます。一部のワークフローまたは承認済みセッションに限定されたキーの場合は`This API key only reaches sessions inside its workflow or status limits, so it can't use this endpoint.`が返されます。 content: application/json: schema: type: object properties: detail: type: string description: 人が読めるエラーメッセージ。 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. Scoped key without decisions read: value: detail: This API key has no read access to decisions. Key limited to workflows or approved sessions: value: detail: >- This API key only reaches sessions inside its workflow or status limits, so it can't use this endpoint. Outside the IP allowlist: value: detail: This API key can't be used from this IP address. '404': description: >- 送信先がアプリケーションに存在しないか削除されています。または、配信が存在しない、別の送信先に属している、もしくは利用できなくなっています。 content: application/json: schema: type: object properties: detail: type: string description: 人が読めるエラーメッセージ。 examples: Destination not found: value: detail: Webhook destination not found. Delivery not found: value: detail: Webhook delivery not found. '429': description: >- レート制限を超過しました。このAPIキーで、現在の1分間のウィンドウ内にGETリクエストが600件を超えました。`Retry-After`秒待ってから再試行してください。 headers: Retry-After: description: 再試行までに待機する秒数。 schema: type: integer minimum: 1 example: 30 X-RateLimit-Limit: description: 1分間のウィンドウで許可されるリクエスト数（600）。 schema: type: integer example: 600 X-RateLimit-Remaining: description: 現在のウィンドウで残っているリクエスト数。 schema: type: integer example: 0 X-RateLimit-Reset: description: 現在のウィンドウがリセットされるUnix時刻(秒)。 schema: type: integer example: 1792056120 X-RateLimit-Scope: description: 超過した予算の名前。 schema: type: string example: generic-get content: application/json: schema: type: object properties: detail: type: string description: 人が読めるエラーメッセージ。 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/deliveries/66666666-7777-8888-9999-000000000001/' \ -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_delivery( "11111111-2222-3333-4444-555555555555", "66666666-7777-8888-9999-000000000001", ) 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.retrieveDelivery( "11111111-2222-3333-4444-555555555555", "66666666-7777-8888-9999-000000000001", ); 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.RetrieveDelivery(ctx, \"11111111-2222-3333-4444-555555555555\", \"66666666-7777-8888-9999-000000000001\")\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().retrieveDelivery("11111111-2222-3333-4444-555555555555", "66666666-7777-8888-9999-000000000001"); System.out.println(result); - lang: php label: PHP source: >- webhooks->destinations->retrieveDelivery('11111111-2222-3333-4444-555555555555', '66666666-7777-8888-9999-000000000001'); print_r($result->toArray()); - lang: ruby label: Ruby source: |- require "didit" # Reads DIDIT_API_KEY. didit = Didit::Client.new result = didit.webhooks.destinations.retrieve_delivery( "11111111-2222-3333-4444-555555555555", "66666666-7777-8888-9999-000000000001" ) 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.RetrieveDeliveryAsync("11111111-2222-3333-4444-555555555555", "66666666-7777-8888-9999-000000000001"); Console.WriteLine(JsonSerializer.Serialize(result)); components: schemas: WebhookDestinationDeliveryDetail: type: object description: Webhookの送信先への配信試行1件。Diditが送信したリクエストヘッダーと本文をそのまま含みます。 required: - uuid - session_id - request_url - response_status - response_time_ms - status - webhook_type - created_at - request_header - request_body properties: uuid: type: string format: uuid description: 配信ID。詳細取得と再送の呼び出しに使用します。 session_id: type: string format: uuid nullable: true description: >- イベントの対象となるユーザー認証セッション。企業セッション、ユーザー、企業、取引、トラベルルール、ワークフローのイベントでは`null`です。 request_url: type: string format: uri nullable: true description: 配信の送信先URL。イベント生成時点の送信先のURLです。 response_status: type: integer nullable: true description: >- エンドポイントが返したHTTPステータス。配信がキューに入っていてまだ試行されていない間は`null`です。HTTP応答を受信しなかった場合、Diditは独自のステータスを記録します。エンドポイントが5秒以内に応答しなかった場合は`504`、接続に失敗した場合は`503`、URLが安全でないとして拒否された場合(プライベートアドレスや内部アドレスなど)は`400`、その他のリクエストエラーの場合は`404`です。`400`以上は配信失敗とみなされます。 response_time_ms: type: integer nullable: true minimum: 0 description: 試行にかかった時間(ミリ秒)。配信がキューに入っている間は`null`です。 status: type: string nullable: true description: >- イベント生成時に報告されたステータス。セッションイベントではセッションのステータス（例: `Approved`や`In Review`）、ユーザーイベントと企業イベントでは個人または企業のステータス、取引イベントでは取引のステータスです。ステータスを持たないイベントでは`null`です。 webhook_type: $ref: '#/components/schemas/WebhookEvent' created_at: type: string format: date-time description: 配信が作成された日時。 request_header: type: string description: >- Diditが送信したリクエストヘッダー（`Content-Type`、`X-Signature`、`X-Signature-V2`、`X-Signature-Simple`、`X-Timestamp`、`User-Agent`）のJSONテキスト（文字列）です。JSONパーサーで解析してください。署名は含まれますが、署名用シークレットは決して含まれません。 request_body: type: string description: >- Diditが送信したペイロードそのもののJSONテキスト（文字列）です。キーはソートされ、`event_id`と`timestamp`を含みます。JSONパーサーで解析してください。[ペイロードの形式](https://docs.didit.me/ja/integration/webhooks#ペイロードの構造)を参照してください。`media: read`を持たないスコープ付きキーの場合、その中のメディアURLは`null`になります。`sessions: write`を持たない場合、セッショントークンとホスト型検証リンクは`null`になります。このように変更された本文は、署名と一致しなくなります。Diditは、お使いのエンドポイントが返したレスポンス本文を記録しません。 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キーです。Business ConsoleのDevelopers -> API keysで取得できます。プライマリキーはフルアクセス権を持ちます。名前付きキーにはスコープを設定できます。リソースごとのアクセス権（なし、読み取り、書き込み）、一部のワークフローまたは承認済みセッションへの限定、IPアドレスのリストへの限定、有効期限の設定です。401は、キーが誤っている、失効している、または期限切れであることを意味します。403は、キーが送信されていない、キーにこのリソースやアクションへのアクセス権がない、またはIPリスト外のアドレスからリクエストが送信されたことを意味します。セッションのルートでの404は、セッションがキーのワークフローまたはステータスの対象外であることを意味します。メディアへのアクセス権がないキーでは、画像、動画、PDFのURLがnullで返されます。セッションの書き込み権限がないキーでは、セッションのリンクとトークンがnullで返されます。詳細は次を参照してください: https://docs.didit.me/console/api-keys ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.