---
title: "List webhook endpoints"
method: GET
path: "/webhook_endpoints"
---

# List webhook endpoints

`GET /webhook_endpoints`

## Request

- Base URL: `https://api.shortgenius.com/v1`
- URL: `https://api.shortgenius.com/v1/webhook_endpoints`
- Auth: HTTP bearer

List your webhook endpoints. The signing secret is never returned.

## Response `200`

Successful response

- object[]: Your webhook endpoints, newest first.
  - `id` string, uuid, required: Unique ID of the webhook endpoint.
  - `url` string, uri, required: The URL events are delivered to.
  - `events` string[], required: The event types this endpoint is subscribed to.
  - `description` string, nullable, required: Optional label for the endpoint.
  - `status` 'active' | 'paused', required: Whether the endpoint is currently receiving deliveries.
  - `created_at` string, required: When the endpoint was created (ISO 8601).
  - `updated_at` string, required: When the endpoint was last updated (ISO 8601).

## Other responses

- `401`: Unauthorized request

---

[API](https://skmtc.dev/shortgenius/apis/shortgenius-api.md) · [All operations](https://skmtc.dev/shortgenius/apis/shortgenius-api/llms.txt) · [OpenAPI document](https://skmtc.dev/shortgenius/apis/shortgenius-api/revisions/532abda8ff32?raw)