---
title: "Find Webhooks by filter criteria with pagination and sorting"
method: GET
path: "/webhooks"
tags: ["Webhook"]
---

# Find Webhooks by filter criteria with pagination and sorting

`GET /webhooks`

Returns a paginated filtered list of all Webhooks based on the provided criteria. Supports both offset-based (page/size) and cursor-based (startAfter/endAt) pagination. Results can be sorted by any Webhook field using the order parameter.

## Query parameters

- `endAtId` string
- `filter` string
- `order` string
- `page` integer
- `size` integer
- `startAfterId` string

## Headers

- `tenant-id` string, required

## Response `200`

List of Webhooks

- GetWebhooksResponse — Response containing a paginated list of webhooks
  - `totalCount` integer — Total count of webhooks
  - `data` WebhookResponse[] — Array of webhook records
    - `id` string — Unique identifier for the webhook
    - `tenantId` string — ID of the tenant
    - `data` WebhookDataSchema — Schema for webhook data payload
      - `webhookUrl` string, uri, required — The URL endpoint where webhook events will be sent
      - `eventTypes` string[], required — List of event types that will trigger this webhook
      - `headers` object, nullable — Custom HTTP headers to include in webhook requests
      - `isActive` boolean, required — Whether the webhook is currently active and will receive events
    - `createdBy` string — ID of the user who created the webhook
    - `updatedBy` string — ID of the user who updated the webhook
    - `createdAt` string, date-time
    - `updatedAt` string, date-time

## Other responses

- `400` — Invalid filter criteria
- `401` — Unauthorized - Authentication required
- `403` — Forbidden - User does not have required permissions
- `500` — Internal Server Error - An unexpected error occurred

---

[API](https://skmtc.net/certifyos/apis/certify-api-layer.md) · [All operations](https://skmtc.net/certifyos/apis/certify-api-layer/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/certifyos/certify-api-layer/revisions/3d27e9019c7b/schema)