API Reference · Webhook Endpoints

Retrieve a webhook endpoint

Fetches a webhook endpoint by id. Does not return the signing secret.

GET/v1/webhook-endpoints/:id

After creation the signing secret is encrypted at rest and never returned. Retrieve returns everything else — url, enabled events, active flag, metadata.

Returnswebhook_endpoint object

Path parameters

idstringRequired

Webhook endpoint id (`we_…`).

Errors

404

resource_missing

No endpoint exists with that id.

Request

curl https://lunipay.io/api/v1/webhook-endpoints/we_01JRZKC5PRGHKV82AW7XNMFD9H \
  -H "Authorization: Bearer sk_test_YOUR_KEY"

Response

{
  "id": "we_01JRZKC5PRGHKV82AW7XNMFD9H",
  "object": "webhook_endpoint",
  "livemode": false,
  "url": "https://example.com/webhooks/lunipay",
  "description": "Production webhook receiver",
  "enabled_events": [
    "checkout.session.completed",
    "payment.succeeded",
    "payment.failed"
  ],
  "is_active": true,
  "created": 1713100800,
  "updated": 1713100800
}