---
title: "List Webhook Endpoints"
method: GET
path: "/webhook_endpoints"
---

# List Webhook Endpoints

`GET /webhook_endpoints`

## Request

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

Returns webhook endpoints for the authenticated project in newest-first order.

## Query parameters

- `limit` integer
- `after` string, nullable

## Response `200`

Success

- WebhookEndpointListResource
  - `object` 'list', required: The object type, which is always list.
  - `data` WebhookEndpointBody[], required: The webhook endpoints in this page.
    - `id` string, required: The unique ID of the webhook endpoint.
    - `object` 'webhook_endpoint', required: The object type, which is always webhook_endpoint.
    - `created_at` integer, required: The Unix timestamp when the endpoint was created.
    - `updated_at` integer: The Unix timestamp of the last endpoint configuration or signing-secret change. Initialized at creation; tests and unchanged updates do not advance it.
    - `name` string, required: The human-readable name of the endpoint.
    - `url` string, required: The HTTPS URL that receives webhook deliveries.
    - `event_types` string[], required: The event types that trigger deliveries to this endpoint.
    - `signing_secret_hint` string, nullable, required: A masked hint for the endpoint's signing secret.
  - `first_id` string, nullable, required: The ID of the first endpoint in this page.
  - `last_id` string, nullable, required: The ID of the last endpoint in this page.
  - `has_more` boolean, required: Whether more webhook endpoints are available.

## Other responses

- `400`: The request parameters are invalid.
- `404`: The pagination cursor does not identify a webhook endpoint in the authenticated project.

## Changes

- **2026-10-06** `487892d3954e`: 2 info
  - added the optional property `error/misalignment/review_target` to the response with the `400` status
  - added the optional property `error/misalignment/review_target` to the response with the `404` status
- **2026-10-05** `7f654af7f94f`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/omnistack-sh/apis/openai-api/changes/webhook_endpoints/get.md)

---

[API](https://skmtc.dev/omnistack-sh/apis/openai-api.md) - [All operations](https://skmtc.dev/omnistack-sh/apis/openai-api/llms.txt) - [OpenAPI document](https://skmtc.dev/omnistack-sh/apis/openai-api/revisions/0a26f104d35f?raw)