---
title: "List block webhooks"
method: GET
path: "/api/v2/{coin}/webhooks"
tags: ["Webhook"]
---

# List block webhooks

`GET /api/v2/{coin}/webhooks`

Returns block webhooks. The types of webhooks are `block` and
`wallet_confirmation` notifications.

## Path parameters

- `coin` string, required — A cryptocurrency or token ticker symbol.

## Response `200`

OK

- object
  - `webhooks` object[]
    - `type` 'block' — Event type to listen to.
    - `userId` string
    - `id` string
    - `label` string
    - `created` string, date-time
    - `coin` string — A cryptocurrency or token ticker symbol.
    - `url` string, uri, required
    - `version` integer — 2 for coins running on API v2.
    - `numConfirmations` integer
    - `state` 'active' | 'suspended' — If `active`, indicates the webhook can trigger and send to the URL. If `suspended`, indicates the webhook can't trigger.
    - `lastAttempt` string, date-time
    - `failingSince` string, date-time
    - `successiveFailedAttempts` integer
    - `walletId` string
    - `allowBlockedHosts` boolean
    - `allToken` boolean
    - `txRequestStates` TransactionRequestState1[] — If present, only transaction request state changes from the list will trigger notifications. If not present, all transaction request state changes will trigger notifications.
    - `txRequestTransactionStates` TransactionState1[] — If present, only transaction request transaction state changes from the list will trigger notifications. If not present, all transaction request transaction state changes will trigger notifications.
    - `identityStatus` IdentityStatus[] — If present, only identity status changes from the list will trigger notifications. If not present, all identity status changes will trigger notifications.
    - `userKycState` VerifiedKycState[] — If present, only user kyc state changes from the list will trigger notifications. If not present, all kyc state changes will trigger notifications.
    - `enterpriseKycState` VerifiedKycState[] — If present, only enterprise kyc state changes from the list will trigger notifications. If not present, all kyc state changes will trigger notifications.

---

[API](https://skmtc.net/bitgo/apis/bitgo-api.md) · [All operations](https://skmtc.net/bitgo/apis/bitgo-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bitgo/bitgo-api/revisions/e445c15e5bee/schema)