---
title: "List webhook endpoints"
method: GET
path: "/webhook_endpoints"
tags: ["Webhook endpoints"]
---

# List webhook endpoints

`GET /webhook_endpoints`

Lists the webhook endpoints of your organization for the `live` or `test` mode of the API key used. Deleted endpoints are not returned, and `secret` is always `null` outside creation.

## Response `200`

List of webhook endpoints for the current mode. Deleted endpoints are excluded and `secret` is always `null`.

- WebhookEndpoint[]
  - `id` string, required — Unique identifier of the webhook endpoint.
  - `object` 'webhook_endpoint', required — Type of the object. Always `webhook_endpoint`.
  - `created_at` string, date-time, required — ISO 8601 timestamp of when the webhook endpoint was created.
  - `description` string, nullable, required — Optional free-text description of the endpoint.
  - `enabled_events` string[], required — Event types that trigger a notification to this endpoint.
  - `mode` 'test' | 'live', required — Mode of the object. `live` objects use real institution data, `test` objects use fake data for integration testing.
  - `name` string, nullable, required — Optional name to identify the endpoint.
  - `secret` string, nullable, required — Secret used to verify the signature of the webhooks sent to the endpoint. Only returned when the endpoint is created; `null` in every other response.
  - `status` 'disabled' | 'enabled', required — Whether the endpoint currently receives event notifications.
  - `url` string, required — HTTPS URL that receives the event notifications.

## Other responses

- `401` — Invalid or missing API key.

---

[API](https://skmtc.net/fintoc/apis/fintoc-api.md) · [All operations](https://skmtc.net/fintoc/apis/fintoc-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fintoc/fintoc-api/revisions/9dafa63688a3/schema)