---
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). The response also includes per-status counts across all of your subscriptions.

## Query parameters

- `page` integer
- `pageSize` integer
- `status` 'active' | 'failing' | 'blocked' | 'disabled'

## 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
    - `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

---

[API](https://skmtc.net/mobilerun/apis/workflows.md) · [All operations](https://skmtc.net/mobilerun/apis/workflows/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mobilerun/workflows/revisions/1bc499aa8f99/schema)