> ## Documentation Index
> Fetch the complete documentation index at: https://diameterpay.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Get a Single Webhook Event Record by Its Unique ID

> GET /v1/webhooks/events/{id} — 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](https://diameterpay.mintlify.site/api-reference/webhooks/get-event-deliveries.md) 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

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

### Response

```json theme={null}
{
  "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](https://diameterpay.mintlify.site/api-reference/webhooks/get-event-deliveries.md) — View all delivery attempts for this event, including HTTP status codes and error details.
* [Search Events](https://diameterpay.mintlify.site/api-reference/webhooks/search-events.md) — Query events across your tenant by type, context, or delivery status.
* [Redeliver Events](https://diameterpay.mintlify.site/api-reference/webhooks/redeliver-events.md) — 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. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.