Get a Single Webhook Event Record by Its Unique ID

GET /v1/webhooks/events/ — Retrieves a single webhook event including its full JSON payload, context, and metadata. Requires webhooks.read scope.

This endpoint retrieves the complete record for a single webhook event, including the full JSON payload that was (or will be) delivered to your subscribed endpoints. Use it to inspect the exact data Diameter sent, verify the contents of a specific event during debugging, or retrieve an event’s contextId to look up the related resource. To see whether and when this event was delivered, use the Get Event Deliveries endpoint.

​

Endpoint

GET /v1/webhooks/events/{id}

Required scope: webhooks.read

​

Request Headers

Header	Required	Description
Authorization	Yes	Bearer {access_token}

​

Path Parameters

id · string · required

The unique identifier of the webhook event to retrieve.

​

Response — 200 OK

id · string

Unique identifier for this webhook event.

tenantId · string

The ID of the tenant this event belongs to.

eventType · string

The event type string, e.g. PAYMENT_WIRE_OUTBOUND_COMPLETED or ACCOUNT_CREATED.

contextId · string

The ID of the resource that triggered this event — for example, a payment ID or account ID.

contextType · string

The resource category that generated the event. One of: PAYMENT, END_USER, COUNTERPARTY, ACCOUNT.

payload · object

The full event payload as a JSON object. The structure varies by eventType. This is the exact body delivered to your webhook endpoint.

createdAt · string

ISO 8601 timestamp of when the event was generated by Diameter.

​

Examples

​

Retrieve a webhook event by ID

curl --request GET \
  --url https://api.diameterpay.com/v1/webhooks/events/evt_a1b2c3d4e5f6789012345678 \
  --header 'Authorization: Bearer {access_token}'

​

Response

{
  "id": "evt_a1b2c3d4e5f6789012345678",
  "tenantId": "ten_0987654321fedcba",
  "eventType": "PAYMENT_WIRE_OUTBOUND_COMPLETED",
  "contextId": "pay_9f8e7d6c5b4a3210",
  "contextType": "PAYMENT",
  "payload": {
    "eventType": "PAYMENT_WIRE_OUTBOUND_COMPLETED",
    "paymentId": "pay_9f8e7d6c5b4a3210",
    "status": "COMPLETED",
    "amount": 150000,
    "currency": "USD",
    "senderAccountId": "acc_1234567890abcdef",
    "beneficiaryName": "Acme Corp",
    "beneficiaryAccountNumber": "****6789",
    "routingNumber": "021000021",
    "memo": "Invoice #INV-2024-0042",
    "completedAt": "2024-06-10T15:32:00.000Z"
  },
  "createdAt": "2024-06-10T15:32:01.000Z"
}

​

Related Endpoints

• Get Event Deliveries — View all delivery attempts for this event, including HTTP status codes and error details.
• Search Events — Query events across your tenant by type, context, or delivery status.
• Redeliver Events — Re-queue this event for delivery to a subscription.

​

Error Responses

Status	Description
404 Not Found	No event with the given id exists for your tenant.
403 Forbidden	Your token does not have the webhooks.read scope.