---
title: "Search Webhooks"
method: GET
path: "/v2/webhook/list"
tags: ["Webhook"]
---

# Search Webhooks

`GET /v2/webhook/list`

# List Webhooks

Returns paginated webhook subscriptions.

## Filters

- `events`: comma-separated event names
- `url`: partial URL match
- `client_id`: creator client id filter (`created_by_client_id`)

## Pagination

- `page`: zero-based page index (default `0`)
- `page_size`: items per page (default `10`)

## Response Notes

Each webhook includes `created_by_client_id` to support operational tracing and ownership filtering.

## Query parameters

- `events` string
- `url` string
- `client_id` string
- `page` integer
- `page_size` integer

## Response `200`

Successful Response

- WebhookSearchResponse
  - `data` WebhookResponse[], required
    - `id` string, required
    - `event` 'test' | 'event.catalog.item.add' | 'event.catalog.item.update' | 'event.catalog.item.delete' | 'event.catalog.item.table.row.add' | 'event.catalog.item.table.row.update' | 'event.catalog.item.table.row.delete' | 'event.catalog.custom' | 'event.contract.add' | 'event.contract.update' | 'event.contract.delete' | 'event.project.integration.start' | 'event.project.start' | 'event.project.finish' | 'event.project.approval.submitted' | 'event.project.step.status.change' | 'event.catalog.modification' | 'event.contact.info.upserted' | 'event.integration.status.updated' | 'event.catalog.vendor.manager.modified' | 'event.contract.details.upserted' | 'event.table.row.upserted', required — An enumeration.
    - `url` string, required
    - `args` object
    - `is_active` boolean
    - `fail_count` integer
    - `created_by_client_id` string
  - `total` integer, required
  - `page` integer, required
  - `page_size` integer, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/expent/apis/expent-apis.md) · [All operations](https://skmtc.dev/expent/apis/expent-apis/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/expent/expent-apis/revisions/ce1d50af5e2c/schema)