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

# Get Widget Event

> Get a single widget event by ID.

`GET /api/v1/widgets/events/:eventId`

Retrieves a specific widget event by its unique identifier. The event must belong to a deposit session owned by the authenticated business.

## Parameters

### Path

| Name      | Type     | Required | Description         |
| --------- | -------- | -------- | ------------------- |
| `eventId` | `string` | Yes      | The widget event ID |

## Request example

```shell theme={null}
curl --request GET 'https://payments.bleepay.com/api/v1/widgets/events/evt_abc123' \
  --header 'Authorization: Bearer <business_token>'
```

## Response

### Response schema

| Field              | Type               | Description                                                 |
| ------------------ | ------------------ | ----------------------------------------------------------- |
| `id`               | `string`           | Unique event identifier                                     |
| `businessId`       | `string`           | The business ID                                             |
| `depositSessionId` | `string`           | The deposit session ID                                      |
| `type`             | `string`           | Event type (e.g. `deposit.confirmed`)                       |
| `payload`          | `object`           | Full event data specific to the event type                  |
| `payloadHash`      | `string` or `null` | Hash of the event payload for integrity verification        |
| `status`           | `string`           | Event status: `PENDING`, `ENABLED`, `DISABLED`, `SUSPENDED` |
| `createdAt`        | `string`           | ISO 8601 creation timestamp                                 |
| `updatedAt`        | `string`           | ISO 8601 last update timestamp                              |

### Example response

```json theme={null}
{
  "id": "evt_abc123",
  "businessId": "biz_abc123",
  "depositSessionId": "dep_a1b2c3d4e5f6",
  "type": "deposit.confirmed",
  "payload": {
    "amount": "100",
    "currency": "USDC",
    "network": "polygon",
    "txid": "0x7a1b2c3d...",
    "srcAddress": "0xPayerWallet123..."
  },
  "payloadHash": "a1b2c3d4e5f6...",
  "status": "ENABLED",
  "createdAt": "2026-06-09T12:05:00.000Z",
  "updatedAt": "2026-06-09T12:05:00.000Z"
}
```

### Error responses

| Status | Code           | Description                       |
| ------ | -------------- | --------------------------------- |
| `401`  | `unauthorized` | Missing or invalid authentication |
| `404`  | `not_found`    | Widget event not found            |