---
title: "List webhook endpoints"
method: GET
path: "/api/v3/webhook_endpoints/"
tags: ["Webhooks"]
---

# List webhook endpoints

`GET /api/v3/webhook_endpoints/`

## Request

- Base URL: `https://embedded.improvado.io`
- URL: `https://embedded.improvado.io/api/v3/webhook_endpoints/`
- Auth: one of:
  - HTTP bearer
  - API key in cookie `dts_session_id`
- TypeScript: <https://skmtc.dev/improvado/apis/improvado-embedded-api-v3/docs/api/v3/webhook_endpoints/get.ts> (a function with typed inputs; its response is checked against the schema)

List webhook endpoints registered in the current workspace.

## Response `200`

A paginated list of webhook endpoints

- PaginatedWebhookEndpointList
  - `count` integer
  - `next` string, nullable
  - `previous` string, nullable
  - `results` WebhookEndpointListItem[]
    - `id` integer: Webhook endpoint ID
    - `url` string, uri: Receiver URL
    - `status` 'unverified' | 'active': Endpoint lifecycle status. `unverified` endpoints do not receive event deliveries.
    - `consecutive_failures` integer: Number of consecutive failed deliveries since the last successful delivery
    - `subscriptions_count` integer: Number of event types this endpoint is subscribed to
    - `created_at` string, date-time
    - `updated_at` string, date-time

## Other responses

- `401`: Authentication credentials were not provided.
- `403`: Embedded API is not enabled for this agency, or workspace header is missing.

---

[API](https://skmtc.dev/improvado/apis/improvado-embedded-api-v3.md) - [All operations](https://skmtc.dev/improvado/apis/improvado-embedded-api-v3/llms.txt) - [OpenAPI document](https://skmtc.dev/improvado/apis/improvado-embedded-api-v3/revisions/a881099bd6c4?raw)