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

# List all webhook endpoints

`GET /v1/webhook_endpoints`

Returns a list of your webhook endpoints.

## Query parameters

- `ending_before` string
- `expand` string[]
- `limit` integer
- `starting_after` string

## Response `200`

Successful response.

- object
  - `data` WebhookEndpoint[], required
    - `api_version` string, nullable — The API version events are rendered as for this webhook endpoint.
    - `application` string, nullable — The ID of the associated Connect application.
    - `created` integer, required — Time at which the object was created. Measured in seconds since the Unix epoch.
    - `description` string, nullable — An optional description of what the webhook is used for.
    - `enabled_events` string[], required — The list of events to enable for this endpoint. `['*']` indicates that all events are enabled, except those that require explicit selection.
    - `id` string, required — Unique identifier for the object.
    - `livemode` boolean, required — If the object exists in live mode, the value is `true`. If the object exists in test mode, the value is `false`.
    - `metadata` object, required — Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
    - `object` 'webhook_endpoint', required — String representing the object's type. Objects of the same type share the same value.
    - `secret` string — The endpoint's secret, used to generate [webhook signatures](https://docs.stripe.com/webhooks/signatures). Only returned at creation.
    - `status` string, required — The status of the webhook. It can be `enabled` or `disabled`.
    - `url` string, required — The URL of the webhook endpoint.
  - `has_more` boolean, required — True if this list has another page of items after this one that can be fetched.
  - `object` 'list', required — String representing the object's type. Objects of the same type share the same value. Always has the value `list`.
  - `url` string, required — The URL where this list can be accessed.

## Other responses

- `default` — Error response.

---

[API](https://skmtc.net/stripe/apis/spec3.md) · [All operations](https://skmtc.net/stripe/apis/spec3/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/stripe/spec3/revisions/3653ad45bbec/schema)