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

# List Webhooks

`GET /webhooks`

Retrieve a paginated list of webhooks

## Query parameters

- `page` integer
- `page_size` integer
- `enabled` '0' | '1'
- `url` string
- `event` string
- `created_after` string, date-time
- `created_before` string, date-time
- `sort_by` 'url' | 'enabled' | 'created_on' | 'last_changed_on' | 'consecutive_failures'
- `sort_order` 'asc' | 'desc'
- `workspace_id` string, uuid

## Response `200`

Webhooks retrieved successfully

- WebhookListResponse — Paginated list of webhooks
  - `results` Webhook[], required
    - `id` string, uuid, required — Unique identifier for the webhook
    - `url` string, uri, required — Webhook URL
    - `description` string, nullable — Webhook description
    - `events` string[], required — Events that trigger this webhook
    - `enabled` boolean, required — Whether the webhook is enabled
    - `consecutive_failures` integer — Number of consecutive delivery failures
    - `auto_disabled_at` string, date-time, nullable — Timestamp when the webhook was auto-disabled due to failures
    - `created_at` string, date-time, required — Webhook creation timestamp
    - `updated_at` string, date-time — Webhook last update timestamp
  - `pagination` Pagination, required — Pagination metadata for list responses
    - `current_page` integer, required
    - `page_size` integer, required
    - `total_count` integer, required
    - `total_pages` integer, required

## Other responses

- `400` — Validation error - invalid date format or sort parameters
- `401` — Unauthorized - Invalid or missing API key
- `429` — Too Many Requests - Rate limit exceeded

---

[API](https://skmtc.dev/firma/apis/firma-partner-api.md) · [All operations](https://skmtc.dev/firma/apis/firma-partner-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/firma/firma-partner-api/revisions/5c03d6a9d080/schema)