Skip to main content
GET
/
custodians
/
me
/
alerts
/
webhooks
/
{alertWebhookId}
/
delivery-events
List alert webhook delivery events
curl --request GET \
  --url https://api.portalhq.io/api/v3/custodians/me/alerts/webhooks/{alertWebhookId}/delivery-events \
  --header 'Authorization: Bearer <token>'
{
  "results": [
    {
      "id": "cm5abc123def456ghi789jkl0",
      "type": "EIP_155_TX_V1",
      "event": {
        "data": [
          {
            "transactionHash": "0x4978a4ba15a018532791ba4491e48b1aa8b544309c1ffce062bb1fb7e84dc069",
            "chainId": "eip155:11155111"
          }
        ],
        "metadata": {
          "deliveryEventId": "cm5abc123def456ghi789jkl0"
        },
        "type": "EIP_155_TX_V1"
      },
      "status": "DELIVERED",
      "sentAt": "2025-01-20T10:30:00.000Z",
      "attempts": 1,
      "createdAt": "2025-01-20T10:29:58.000Z"
    },
    {
      "id": "cm5xyz987wvu654tsr321qpo0",
      "type": "EIP_155_TX_V1",
      "event": {
        "data": [
          {
            "transactionHash": "0x9b1c2d3e4f567890abcdef1234567890abcdef1234567890abcdef1234567890",
            "chainId": "eip155:1"
          }
        ],
        "metadata": {
          "deliveryEventId": "cm5xyz987wvu654tsr321qpo0"
        },
        "type": "EIP_155_TX_V1"
      },
      "status": "FAILED",
      "sentAt": "2025-01-20T11:05:12.000Z",
      "attempts": 10,
      "createdAt": "2025-01-20T11:00:00.000Z"
    }
  ],
  "metadata": {
    "alertWebhook": {
      "id": "cm4voycw2001f68veade3tr0i",
      "url": "https://example.com/alerts-webhooks/1/events"
    },
    "cursor": "cm5xyz987wvu654tsr321qpo0",
    "take": 100,
    "hasMore": true
  }
}

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

​
take
integer
default:100

The number of delivery events to retrieve. Min 1, max 100. Default 100.

Required range: 1 <= x <= 100
​
cursor
string

The delivery event ID to use for cursor-based pagination. Pass the id of the last item from the previous response.

​
statuses
string

Comma-delimited list of delivery event statuses to filter by. Valid values: PENDING, DELIVERED, FAILED, REPLAYING.

​
eventTypes
string

Comma-delimited list of alert webhook event types to filter by. Valid values: EIP_155_TX_V1, PRE_SIGN_V1, SOLANA_TX_V1, SOLANA_TX_V2, SOLANA_APPROVE_V1, SOLANA_APPROVE_V2, SOLANA_REVOKE_V1, SOLANA_REVOKE_V2, SOLANA_DELEGATED_TRANSFER_V2, WALLET_EJECT_V1.

​
orderBy
enum<string>
default:sentAt

Field to order results by. Defaults to sentAt.

Available options:
sentAt,
createdAt
​
orderDirection
enum<string>
default:desc

Sort direction. Defaults to desc.

Available options:
asc,
desc
​
since
number

Returns only delivery events created after this Unix timestamp (in seconds).

​
until
number

Returns only delivery events created before this Unix timestamp (in seconds).

Response

Alert webhook delivery events retrieved successfully

​
results
object[]
​
metadata
object