---
title: "List webhook events"
method: GET
path: "/webhook/{webhook_uuid}/events"
tags: ["Org Level Webhooks"]
---

# List webhook events

`GET /webhook/{webhook_uuid}/events`

## Request

- Base URL: `https://api.ocrolus.com/v1/account/settings`
- URL: `https://api.ocrolus.com/v1/account/settings/webhook/{webhook_uuid}/events`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://auth.ocrolus.com/oauth/token`

This API retrieves a list of events configured for a webhook using the webhook's universally unique identification code (UUID).

---
You can find a list of supported org-level event types and their sample notifications in the [Org-level webhook guide](doc:organization-level-webhook#available-events).

## Path parameters

- `webhook_uuid` string, uuid, required

## Response `200`

OK

- InlineResponse2001
  - `status` string: The success response status received from the server.
  - `message` string: The success message received from the server corresponding to the response status.
  - `response` InlineResponse2001Response
    - `events` Event[]
      - `description` string: A written description of the event.
      - `uuid` string, uuid: The universally unique identification code (UUID) of the event.
      - `is_active` boolean: Determines if notificiations will be sent to the provided webhook.
      - `name` string: The name of the notification event delivered by Ocrolus.
      - `reason` string: Describes the type of notification the event triggered.
      - `type` 'STATUS' | 'ISSUE': The type of the event. The current supported event types are `STATUS` and `ISSUE`.
      - `severity` 'LOW' | 'MODERATE' | 'HIGH': The configured importance level for this type of event.

## Other responses

- `400`: Webhook with uuid {uuid} not found

---

[API](https://skmtc.dev/ocrolus/apis/org-level-webhooks.md) - [All operations](https://skmtc.dev/ocrolus/apis/org-level-webhooks/llms.txt) - [OpenAPI document](https://skmtc.dev/ocrolus/apis/org-level-webhooks/revisions/ef603756da38?raw)