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

# List webhook endpoints

`GET /api/v1/webhook-endpoints`

## Request

- Base URL: `https://api.imagestep.dev`
- URL: `https://api.imagestep.dev/api/v1/webhook-endpoints`
- Auth: API key in header `Authorization`

Every endpoint registered on this account, newest first. There are at most 10, so the list is not paged. The signing secret is masked (`secretHint`); it is returned in full only by create and rotate-secret. An endpoint the service switched off after repeated failures reads `enabled: false` with `disabledAt` and `disabledReason`.

## Response `200`

OK

## Other responses

- `429`: Rate limited — `error.code` is `rate_limited` and `retryable` is true. `Retry-After` says how many seconds to wait.

---

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