---
title: "Inspect a subscription"
method: GET
path: "/webhooks/{id}"
---

# Inspect a subscription

`GET /webhooks/{id}`

## Request

- Base URL: `https://vineverse.bible/api/v1`
- URL: `https://vineverse.bible/api/v1/webhooks/{id}`
- Auth: none required

Status and the outcome of the last delivery. Authorise with the secret from registration, as `Authorization: Bearer <secret>`. The secret is never returned.

## Path parameters

- `id` string, uuid, required

## Response `200`

The subscription, without its secret.

- Webhook
  - `id` string, uuid
  - `url` string, uri
  - `events` string[]
  - `createdAt` string, date-time
  - `status` 'active' | 'failing' | 'disabled'
  - `failures` integer: Consecutive failures. Ten disables the subscription.
  - `lastDeliveryAt` string, date-time, nullable
  - `lastResult` string, nullable

## Other responses

- `404`: No such subscription, or the secret does not match. The two are deliberately indistinguishable.
- `429`: Too many requests. Carries Retry-After. See the rate limit note in `info`.

---

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