---
title: "Retrieve a webhook"
method: GET
path: "/seller/webhooks/{webhookId}"
tags: ["seller-webhooks"]
---

# Retrieve a webhook

`GET /seller/webhooks/{webhookId}`

Retrieve one webhook endpoint by 'webhookId' for the authenticated seller.

Use this endpoint when loading details for a specific endpoint before editing, testing, or troubleshooting.

Typical use cases:

- Populate a webhook details page.
- Confirm the active subscription set before replacing subscriptions.
- Inspect latest delivery health fields (last success/failure and failure counters).

Behavior notes:

- Returns 404 when the webhook id is unknown or does not belong to the current seller.
- Response shape matches webhook records returned by list endpoints, including subscriptions.

## Path parameters

- `webhookId` string, required — Identifier of the webhook endpoint to retrieve

## Response `200`

Webhook endpoint

- SellerWebhookEndpoint — Represents a webhook endpoint configured by a seller to receive event notifications.
  - `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` — Webhook or 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/e8d78a3a2e8b/schema)