---
title: "List organization webhooks"
method: GET
path: "/api/v2/organization/{organizationId}/webhook"
tags: ["Organization Webhooks"]
---

# List organization webhooks

`GET /api/v2/organization/{organizationId}/webhook`

List all webhooks for a specified organization.

## Path parameters

- `organizationId` string, required

## Query parameters

- `type` 'transfer' | 'txRequest' | 'pendingapproval' | 'txRequestTransaction' | 'bankAccount' | 'identityStatus' | 'idvStatus' | 'userKycState' | 'enterpriseKycState' | 'accessToken' | 'reversal' | 'tradeOrder' | 'whitelistApproved' | 'whitelistRejected'
- `prevId` string
- `limit` string, number

## Response `200`

OK

- ListOrganizationWebhooksResponseScoped — Scoped list response for organization 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` 'transfer' | 'txRequest' | 'pendingapproval' | 'txRequestTransaction' | 'bankAccount' | 'identityStatus' | 'idvStatus' | 'userKycState' | 'enterpriseKycState' | 'accessToken' | 'reversal' | 'tradeOrder' | 'whitelistApproved' | 'whitelistRejected'
    - `numConfirmations` number
    - `lastAttempt` string, date-time
    - `failingSince` string, date-time
    - `allToken` boolean
    - `txRequestStates` string[]
    - `txRequestTransactionStates` string[]
  - `nextBatchPrevId` string

## Other responses

- `401` — Unauthorized
- `403` — Forbidden

---

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