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

# List user webhooks

`GET /hooks`

Returns a list of currently registered webhooks for the requested **event**. (Permitted scopes: **fax:all:read**, **fax:webhook:read**)

## Query parameters

- `event` 'fax_received' | 'fax_sent' | 'fax_page_received', required — Webhook event type

## Response `200`

Response containing a list of currently registered webhooks

- WebhookList — List of webhooks
  - `data` Webhook[]
    - `id` string — Webhook ID
    - `target` string, required — Webhook target URL
    - `event` 'fax_received' | 'fax_sent' | 'fax_page_received', required — Webhook event type
    - `numbers` string[], nullable — A list of phone numbers used to filter webhook triggers. If specified, the webhook will only fire for inbound or outbound calls involving these numbers. Pass null to disable filtering. An empty array is invalid

## Other responses

- `400` — Error object in case there's a problem with given data
- `500` — Error object in case there's a server error

---

[API](https://skmtc.net/fax/apis/fax-plus-rest-api.md) · [All operations](https://skmtc.net/fax/apis/fax-plus-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fax/fax-plus-rest-api/revisions/c1afc85d2c15/schema)