List wallet webhooks by wallet IDs

post/api/v2/internal/webhook/list

Lists wallet-scoped webhooks for the specified wallet IDs, optionally filtered by webhook type. This endpoint is for internal BitGo use only.

Request Body

One of
type string
Optional wallet webhook type to filter by
Allowed values: txRequest txRequestTransaction transfer transaction transactionRemoved transactionExpire pendingapproval block admin address_confirmation lowFee circuitBreaker lowFeeAddressBalance transaction_finality_on_l1 fundsDeposited stuckTx unspentExpiry twoStepTransfer twoStepDeposit twoStepWithdrawal
Example: stuckTx" | "pendingapproval" | "transaction
walletIds array[string] required
Array of wallet IDs to list wallet-scoped webhooks for.
Min items: >= 1 items
Max items: <= 100 items
Example: ["59cd72485007a239fb00282ed480da1f","59cd72485007a239fb00282ed480da2a"]

200 Response

webhooks array[object] required
Array of webhook objects
id string required
Webhook public ID
url string required
Webhook URL to POST notifications to
type string required
Webhook type
state string required
Webhook state (active, suspended, etc.)
coin string required
Coin
walletId string
Wallet public ID — present for wallet-scoped webhooks
enterpriseId string
Enterprise public ID
organizationId string
Organization public ID — present for org-scoped webhooks

400 Response

name string
Error code
context object required
Properties that apply to a specific error name
error string required
Human-readable error message
requestId string required
Client request id

401 Response

name string
Error code
context object required
Properties that apply to a specific error name
error string required
Human-readable error message
requestId string required
Client request id

403 Response

name string
Error code
context object required
Properties that apply to a specific error name
error string required
Human-readable error message
requestId string required
Client request id

500 Response

name string
Error code
context object required
Properties that apply to a specific error name
error string required
Human-readable error message
requestId string required
Client request id