---
title: "List All Webhooks"
method: GET
path: "/webhooks"
tags: ["Webhooks"]
---

# List All Webhooks

`GET /webhooks`

View all webhooks associated with a specific company with filtering available via query parameters. 

**OAuth Scope required:** `public.webhooks.readWebhooks`

## Query parameters

- `page` integer
- `pageSize` integer

## Headers

- `x-as-user-email` string
- `x-as-user-id` string

## Response `200`

200

- object
  - `page` integer, required
  - `pageSize` integer, required
  - `list` WebhookModel[], required
    - `id` string, required — Unique ID of the webhook
    - `events` WebhookEvent[], required — Array of events to which webhook is subscribed to.
    - `targetURL` string, https-url, required — Target URL to which the webhook is called.
    - `companyId` string, required — Unique ID of the Ironclad company instance to which the webhook belongs to.
    - `status` 'enabled' | 'disabled' | 'disabledBySystem', required — The status of the webhook. If the status is `disabled`, the webhook will not be triggered.
    - `statusLastUpdatedAt` string, date-time — The timestamp of the most recent status change in ISO 8601 format.
    - `statusLastUpdatedBy` string — The user or system ID that made the most recent status change.
    - `consecutiveFailureCount` number, required — The number of consecutive failed deliveries of the webhook. After a certain number of consecutive failures over a certain period of time, the webhook will be disabled. See [more](https://developer.ironcladapp.com/reference/webhook-deactivation).
    - `firstConsecutiveFailure` string, date-time — The timestamp of the first consecutive failure of the webhook in ISO 8601 format.

## Other responses

- `400` — 400

---

[API](https://skmtc.net/ironcladapp/apis/ironclad-public-api.md) · [All operations](https://skmtc.net/ironcladapp/apis/ironclad-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ironcladapp/ironclad-public-api/versions/9459b4cfc1e0/schema)