---
title: "List all executed webhooks"
method: GET
path: "/v4/subscription/webhook"
tags: ["Notifications"]
---

# List all executed webhooks

`GET /v4/subscription/webhook`

## Request

- Base URL: `https://api.tatum.io`
- URL: `https://api.tatum.io/v4/subscription/webhook`
- Auth: API key in header `x-api-key`

> This endpoint is compatible with our deprecated v3 Notifications product. To use it with v3, simply replace 'v4' with 'v3' in the request URL.

<p style="display: none">/v4/subscription/webhook</p>
<p>List all webhooks.</p>

## Query parameters

- `pageSize` number, required
- `offset` number
- `direction` 'asc' | 'desc'
- `failed` boolean
- `subscriptionId` string
- `from` number
- `to` number

## Response `200`

OK

- WebHookV4[]
  - `type` 'ADDRESS_EVENT' | 'CONTRACT_ADDRESS_LOG_EVENT' | 'INCOMING_NATIVE_TX' | 'OUTGOING_NATIVE_TX' | 'OUTGOING_FAILED_TX' | 'PAID_FEE' | 'INCOMING_INTERNAL_TX' | 'OUTGOING_INTERNAL_TX' | 'INCOMING_FUNGIBLE_TX' | 'OUTGOING_FUNGIBLE_TX' | 'INCOMING_NFT_TX' | 'OUTGOING_NFT_TX' | 'INCOMING_MULTITOKEN_TX' | 'OUTGOING_MULTITOKEN_TX' | 'MINT_TX' | 'BURN_TX' | 'SWAP_TX' | 'FAILED_TXS_PER_BLOCK' | 'PRICE_CHANGE', required: Type of the alert.
  - `id` string, required: ID of the WebHook
  - `subscriptionId` string, required: ID of the alert
  - `url` string, required: URL of the endpoint, where HTTP POST request will be sent.
  - `data` object, required: Data of webhook
  - `nextTime` number: Next webhook execution try time
  - `timestamp` number: Webhook execution time
  - `retryCount` number: Number
  - `failed` boolean, required: Flag indicating whether this webhook was successful or not
  - `response` object, required: Response from the server in case the webhook was unsuccessful
    - `code` number: HTTP Status
    - `data` string: Response from the server
    - `networkError` boolean, required: Flag indicating whether an error has been caused by the network
  - `note` string: Any other relevant information such as important updates

## Other responses

- `400`: Bad Request
- `401`: Unauthorized. Not valid or inactive subscription key present in the HTTP Header.
- `500`: Internal server error. There was an error on the server during the processing of the request.

---

[API](https://skmtc.dev/tatum/apis/blockchain-notifications.md) - [All operations](https://skmtc.dev/tatum/apis/blockchain-notifications/llms.txt) - [OpenAPI document](https://skmtc.dev/tatum/apis/blockchain-notifications/revisions/925883906ce5?raw)