---
title: "Get a list of webhooks"
method: GET
path: "/api/v2/organizations/{orgSlug}/webhooks"
tags: ["Webhooks"]
---

# Get a list of webhooks

`GET /api/v2/organizations/{orgSlug}/webhooks`

Retrieve a list of webhooks based on provided filters 

 Required scopes: `flex.settings.webhooks.read`

## Path parameters

- `orgSlug` string, required

## Query parameters

- `$select` string
- `$cursorNext` string
- `$cursorPrev` string
- `$limit` number

## Response `200`

- object
  - `rangeStart` number
  - `rangeEnd` number
  - `cursorNext` string
  - `cursorPrev` string
  - `results` WebhookResultDto[]
    - `_id` string — The _id of the webhook.
    - `url` string — The URL of the endpoint of your server where POST requests will be made.
    - `description` string — A description of the webhook.
    - `eventTypes` string[] — An array containg the type of events associated with the webhook.
    - `secret` string — The secret key used to sign the webhook payload.
    - `isEnabled` boolean — Determines whether the webhook is enabled. If left empty the webhook will be turned on by default.

---

[API](https://skmtc.dev/officernd/apis/authentication-api.md) · [All operations](https://skmtc.dev/officernd/apis/authentication-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/officernd/authentication-api/revisions/6bcd33dc648e/schema)