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

# List wallet webhooks

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

List webhooks set up on the wallet. Currently, the types of
webhooks that can be attached to a wallet are `transfer`,
`pendingapproval`, and `address_confirmation` notifications.

## Path parameters

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

## Response `200`

OK

- object
  - `webhooks` object[]
    - `id` string
    - `label` string
    - `created` string, date-time
    - `coin` string — A cryptocurrency or token ticker symbol.
    - `type` 'txRequest' | 'txRequestTransaction' | 'transfer' | 'transaction' | 'transactionRemoved' | 'transactionExpire' | 'unspentExpiry' | 'pendingapproval' | 'address_confirmation' | 'lowFee' | 'block' | 'admin' | 'circuitBreaker' | 'transaction_finality_on_l1' | 'lowFeeAddressBalance' | 'stuckTx' | 'endInvestorOnboardingInvite' | 'endInvestorOnboardingAccepted' — Event type to listen to.
    - `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` PlatformTransactionRequestState[] — 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` PlatformTransactionState[] — 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` PlatformIdentityStatus[] — If present, only identity status changes from the list will trigger notifications. If not present, all identity status changes will trigger notifications.
    - `userKycState` PlatformVerifiedKycState[] — If present, only user kyc state changes from the list will trigger notifications. If not present, all kyc state changes will trigger notifications.
    - `enterpriseKycState` PlatformVerifiedKycState[] — If present, only enterprise kyc state changes from the list will trigger notifications. If not present, all kyc state changes will trigger notifications.

## Other responses

- `400` — Bad Request

---

[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)