---
title: "Get webhook registration & delivery health (free)"
method: GET
path: "/get-webhook"
tags: ["Notifications"]
---

# Get webhook registration & delivery health (free)

`GET /get-webhook`

## Request

- Base URL: `https://laso.finance`
- URL: `https://laso.finance/get-webhook`
- Auth: API key in header `Authorization`

Returns the calling wallet's webhook registration and its delivery health. The signing secret is never returned here — it is shown once by `POST /register-webhook`; re-register to rotate it.

A registration is auto-disabled after 50 consecutive failed deliveries (`disabled` becomes `true`); re-register to re-enable it.

Requires a Bearer token from `/auth` or `/get-card`.

## Response `200`

Registration state (`registered: false` when none exists)

- object
  - `registered` boolean
  - `url` string, nullable
  - `disabled` boolean: True when auto-disabled after repeated delivery failures. Re-register to re-enable.
  - `disabled_reason` string, nullable
  - `consecutive_failures` number
  - `last_delivery_status` string, nullable: `delivered` or `failed`, or null before the first delivery.
  - `last_delivery_timestamp` number, nullable: Epoch milliseconds of the last delivery attempt.
  - `last_delivery_detail` string, nullable: `HTTP <status>` of the last attempt, or the error message.
  - `last_delivery_message_id` string, nullable: The `webhook-id` header of the last delivery.

## Other responses

- `401`: Missing or invalid Bearer token
- `403`: Account is frozen. The response includes a `frozen_message` field explaining why.

---

[API](https://skmtc.dev/laso/apis/laso-finance-x402-api.md) · [All operations](https://skmtc.dev/laso/apis/laso-finance-x402-api/llms.txt) · [OpenAPI document](https://skmtc.dev/laso/apis/laso-finance-x402-api/revisions/ff8ce20b49ba?raw)