Skip to main content
GET
/
custodians
/
me
/
alerts
/
webhooks
/
{alertWebhookId}
/
events
List alert webhook events
curl --request GET \
  --url https://api.portalhq.io/api/v3/custodians/me/alerts/webhooks/{alertWebhookId}/events \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "blockNumber": 7313326,
      "chainId": "eip155:11155111",
      "confirmed": 1,
      "createdAt": "2024-12-19T20:08:17.086Z",
      "deliveryStatus": "success",
      "errorMessage": null,
      "id": "85f3d2f7-b2ff-417d-b9cb-dc9823b4ae61",
      "retries": 0,
      "transactionHashes": [
        "0x4978a4ba15a018532791ba4491e48b1aa8b544309c1ffce062bb1fb7e84dc069"
      ],
      "type": "EIP_155_TX_V1",
      "updatedAt": "2024-12-19T20:08:17.086Z"
    }
  ],
  "metadata": {
    "alertWebhook": {
      "id": "alertWebhookId1",
      "url": "https://example.com/alerts/webhooks/1/events"
    },
    "cursor": null,
    "limit": 100,
    "total": 4
  }
}

Authorizations

​
Authorization
string
header
required

Portal API Key (Custodian API Key). Pass as a Bearer token in the Authorization header.

Path Parameters

​
alertWebhookId
string
required

The unique identifier of the alert webhook.

Query Parameters

​
eventTypes
enum<string>

The alert webhook event types to filter by.

Available options:
EIP_155_TX_V1
​
deliveryStatuses
enum<string>

Filter by delivery status.

Available options:
success,
failed,
pending
​
since
number

Returns only events that occurred after this Unix timestamp.

​
until
number

Returns only events that occurred before this Unix timestamp.

​
cursor
string

The alert webhook event ID for cursor-based pagination.

​
limit
integer
default:100

The number of events to retrieve. Default is 100.

​
transactionHash
string

Filter by transaction hash.

​
blockNumbers
string

Filter by block numbers (comma-delimited).

​
chainIds
string

Filter by CAIP-2 chain IDs (comma-delimited).

Response

Alert webhook events retrieved successfully

​
data
object[]
​
metadata
object