---
title: "List webhooks"
method: GET
path: "/seller/webhooks"
tags: ["seller-webhooks"]
---

# List webhooks

`GET /seller/webhooks`

Retrieve all webhook endpoints configured for the authenticated seller.

Use this endpoint to build a webhook management screen or to reconcile expected webhook configuration during deployments.

The response includes per-endpoint configuration and health indicators, including:

- URL and optional description.
- Enabled/disabled status.
- Additional headers currently configured.
- Secret value used by your receiver-side verification logic.
- Last success/failure timestamps.
- Consecutive failure counters and subscription events.

Operational guidance:

- Call this endpoint after create, update, subscription changes, or delete operations.
- Use 'enabled' plus failure counters to detect endpoints that require attention.
- Persist webhook ids from this response for follow-up operations such as test, update, or failure inspection.

## Response `200`

Seller webhook endpoints

- SellerWebhookListResponse — Response containing a list of the seller's webhook endpoints.
  - `webhooks` SellerWebhookEndpoint[], required — Collection of webhook endpoints owned by the seller
    - `id` string, required — Unique identifier for the webhook endpoint
    - `url` string, uri, required — Destination URL for webhook deliveries
    - `description` string, nullable — Optional human readable description
    - `enabled` boolean, required — Indicates whether the webhook is currently active
    - `additionalHeaders` object, required — Additional headers sent with each webhook request
    - `secret` string, required — Shared secret used to generate webhook signatures
    - `lastSuccessAt` string, date-time, nullable, required — Timestamp of the most recent successful delivery
    - `lastFailureAt` string, date-time, nullable, required — Timestamp of the most recent failed delivery
    - `consecutiveFailures` integer, required — Current number of consecutive delivery failures
    - `maxConsecutiveFailures` integer, required — Threshold at which the webhook will automatically be disabled
    - `createdAt` string, date-time, required — Timestamp when the webhook endpoint was created
    - `updatedAt` string, date-time, required — Timestamp when the webhook endpoint was last updated
    - `subscriptions` string[], required — Event types that the webhook is subscribed to

## Other responses

- `404` — Seller not found

---

[API](https://skmtc.net/managem/apis/managem-api.md) · [All operations](https://skmtc.net/managem/apis/managem-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/managem/managem-api/versions/6367b514f6ea/schema)