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

# List your webhook subscriptions

`GET /webhooks`

Returns a paginated list of your webhook subscriptions, optionally filtered by status (active, failing, blocked, or disabled) and/or by `search` (a case-insensitive substring match against the URL or description). The response also includes per-status counts across all of your subscriptions.

## Query parameters

- `page` integer
- `pageSize` integer
- `status` 'active' | 'failing' | 'blocked' | 'disabled'
- `search` string — Case-insensitive substring match against the URL or description.
- `mine` 'true' | 'false' — When true, only include webhooks created by you (not just owned by your org).
- `createdBy` string, uuid — Only include webhooks created by this actor id. Mutually exclusive with `mine`.

## Response `200`

Webhook subscriptions

- object
  - `items` object[], required
    - `id` string, uuid, required
    - `url` string, required
    - `eventTypes` string[], required
    - `state` 'ACTIVE' | 'DISABLED' | 'DELETED', required
    - `health` 'healthy' | 'failing' | 'blocked', required — System-observed delivery health. `blocked` endpoints are auto-disabled after sustained failure; PATCH state=ACTIVE to re-enable.
    - `blockedAt` string, nullable, required
    - `blockedReason` string, nullable, required
    - `signingEnabled` boolean, required
    - `description` string, nullable, required
    - `createdBy` string, uuid, nullable, required — Id of the actor who created this endpoint. Null when no creator was recorded.
    - `createdAt` string, required
    - `updatedAt` string, required
  - `pagination` Pagination, required
    - `hasNext` boolean, required
    - `hasPrev` boolean, required
    - `page` integer, required
    - `pageSize` integer, required
    - `pages` integer, required
    - `total` integer, required
  - `counts` object, required
    - `active` number, required
    - `failing` number, required
    - `blocked` number, required
    - `disabled` number, required
    - `total` number, required

## Other responses

- `401` — Unauthorized
- `500` — Internal Server Error

## Changes

- **2026-08-13** `02da4f9ce3fd` — 3 info
  - added the new optional `query` request parameter `createdBy`
  - added the new optional `query` request parameter `mine`
  - added the required property `items/items/createdBy` to the response with the `200` status
- **2026-07-31** `cd80ab1b29b0` — 1 info
  - added the new optional `query` request parameter `search`
- **2026-06-29** `8f06726ac240` — 4 info
  - api tag `Webhooks` added
  - api tag `Public - Webhooks` removed
  - for the `query` request parameter `page`, the exclusiveMinimum was decreased from `true` to `0.00`
  - for the `query` request parameter `pageSize`, the exclusiveMinimum was decreased from `true` to `0.00`
- **2026-06-18** `e61cfb7119bc` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/droidrun/apis/droidrun-cloud/changes/webhooks/get.md)

---

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