---
title: "List enterprise webhooks"
method: GET
path: "/api/v2/enterprise/{enterpriseId}/webhooks"
tags: ["Enterprise Webhooks"]
---

# List enterprise webhooks

`GET /api/v2/enterprise/{enterpriseId}/webhooks`

List all webhooks for the specified enterprise.

## Path parameters

- `enterpriseId` string, required

## Query parameters

- `type` 'bankAccount' | 'accessToken' | 'policyBalanceChange' | 'reversal' | 'mintOrder'
- `prevId` string
- `limit` string, number

## Response `200`

OK

- ListEnterpriseWebhooksResponseScoped — Scoped list response for enterprise webhooks.
  - `webhooks` object[], required
    - `id` string, required
    - `created` string, date-time, required
    - `url` string, uri, required
    - `version` number, required — 2 for coins running on API v2.
    - `scope` 'wallet' | 'enterprise' | 'organization' | 'safe', required
    - `state` 'active' | 'suspended', required — If 'active', indicates the webhook can trigger and send to the URL. If 'suspended', indicates the webhook can't trigger.
    - `successiveFailedAttempts` number, required
    - `listenToFailureStates` boolean, required — Whether or not to listen to failed transactions on chain.
    - `coin` string — A cryptocurrency or token ticker symbol.
    - `label` string — Label of the new webhook.
    - `walletId` string
    - `enterpriseId` string
    - `organizationId` string
    - `userId` string
    - `type` 'bankAccount' | 'accessToken' | 'policyBalanceChange' | 'reversal' | 'mintOrder'
    - `numConfirmations` number
    - `lastAttempt` string, date-time
    - `failingSince` string, date-time
    - `allToken` boolean
    - `txRequestStates` string[]
    - `txRequestTransactionStates` string[]
  - `nextBatchPrevId` string

## Other responses

- `400` — Bad Request
- `404` — Not Found

---

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