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

# List webhooks

`GET /client/webhooks`

## Request

- Base URL: `https://api.roar-ai.com`
- URL: `https://api.roar-ai.com/client/webhooks`
- Auth: HTTP bearer

Registered webhooks (never the signing secret), plus every deliverable event. Requires `webhooks:read`.

## Response `200`

Webhooks

- WebhookList
  - `data` WebhookListItem[], required
    - `id` string, uuid, required
    - `url` string, uri, required
    - `events` WebhookSubscription[], required
    - `description` string, nullable, required
    - `enabled` boolean, required
    - `createdAt` string, date-time, required
    - `lastStatus` integer, nullable, required
    - `lastDeliveryAt` string, date-time, nullable, required
  - `events` WebhookEvent[], required: Every event that can be delivered

## Other responses

- `403`: Key lacks webhooks:read

---

[API](https://skmtc.dev/roar-ai/apis/roar-ai-api.md) · [All operations](https://skmtc.dev/roar-ai/apis/roar-ai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/roar-ai/apis/roar-ai-api/revisions/37e4d0d5a7fe?raw)