---
title: "List outbound webhook metadata"
method: GET
path: "/api/v1/user/webhooks"
tags: ["User", "Webhooks"]
---

# List outbound webhook metadata

`GET /api/v1/user/webhooks`

Account-plane metadata, the exact payload-contract 1.0 event allowlist and worker health. Full signing secrets are never listed; signing secrets are encrypted at rest with a versioned keyring. Unknown event types and schema versions fail closed.

## Response `200`

Webhook metadata

- object
  - `webhooks` OutboundWebhook[]
    - `id` integer, required
    - `url` string, uri, required
    - `events` OutboundWebhookEventTypeV1[], required — Events with a currently wired durable producer. Contracted-but-unwired event types are not subscribable. An empty input is normalized to alert.triggered; wildcard, inactive and unknown values are rejected.
    - `active` boolean, required
    - `secret_prefix` string, required — Non-secret identification prefix.
    - `key_id` string, nullable — Public identifier of the current HMAC signing key.
    - `secret_storage` 'encrypted' | 'migration_required'
    - `last_success_at` string, date-time, nullable
    - `created_at` string, date-time, required
  - `allowed_events` OutboundWebhookEventTypeV1[] — Events with a currently wired durable producer. Contracted-but-unwired event types are not subscribable. An empty input is normalized to alert.triggered; wildcard, inactive and unknown values are rejected.
  - `contracted_events` OutboundWebhookContractedEventTypeV1[] — All event payload contracts known by this API version, including contracted-but-unwired events that cannot yet be subscribed.
  - `worker` WebhookWorkerHealth
    - `available` boolean, required
    - `status` string, required
    - `age_seconds` integer, nullable
    - `reason` string, required
  - `secret_visible_once` true

## Other responses

- `401` — Authentication required (no active session)
- `503` — Account or webhook security schema unavailable

---

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