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

# List webhook endpoints

`GET /webhooks`

## Request

- Base URL: `https://restapi.fax.plus/v3`
- URL: `https://restapi.fax.plus/v3/webhooks`
- Auth: one of:
  - OAuth 2
    - Authorization code: `https://accounts.fax.plus/login?response_type=code&client_id=YOUR_CLIENT_ID&redirect_uri=http://localhost&scope=all`
    - Token URL: `https://accounts.fax.plus/token` scopes: `all`
  - HTTP bearer

List webhook endpoints for this account. Optional `event` filter uses names (`fax_received`). Requires webhooks to be enabled in Integrations. (Permitted scopes: **fax:all:read**, **fax:webhook:read**)

## Query parameters

- `event` 'fax_received' | 'fax_sent' | 'fax_page_received': Webhook event type for /webhooks endpoints
- `limit` integer
- `next` string

## Response `200`

Page of webhook endpoints

- WebhookEndpointList: Page of webhook endpoints
  - `data` WebhookEndpoint[], required
    - `id` string, required
    - `uid` string, nullable
    - `url` string, required
    - `description` string
    - `filter_types` WebhookFilterType[], nullable
    - `channels` string[], nullable
    - `disabled` boolean, nullable
    - `metadata` object
    - `rate_limit` integer, nullable
    - `throttle_rate` integer, nullable
    - `version` integer
    - `created_at` string, date-time
    - `updated_at` string, date-time
  - `next` string, nullable

## Other responses

- `400`: Error object in case there's a problem with given data
- `403`: Error object in case there's a problem with given data
- `404`: Requested resource was not found
- `500`: Error object in case there's a server error

## Changes

- **2026-11-03** `95a35a892239`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/fax/apis/fax-plus-rest-api/changes/webhooks/get.md)

---

[API](https://skmtc.dev/fax/apis/fax-plus-rest-api.md) - [All operations](https://skmtc.dev/fax/apis/fax-plus-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/fax/apis/fax-plus-rest-api/revisions/95a35a892239?raw)