---
title: "Query Webhooks"
method: GET
path: "/v1/webhooks"
tags: ["Webhooks"]
---

# Query Webhooks

`GET /v1/webhooks`

Find webhook configurations belonging to a merchant division. Results are limited to only show webhooks authorized by the X-API-Key.

## Query parameters

- `division_id` string, required

## Response `200`

Success

- object
  - `webhooks` Webhook[]
    - `created_at` integer, required — Webhook creation time in epoch timestamp milliseconds.
    - `event_group` 'all' | 'null', nullable — Subscribe to a group of events. `all`: subscribe to all existing and future event types
    - `events` WebhooksType[], nullable — All events the webhook is subscribed to. Null when `event_group` = `all`.
    - `url` string, required — The full URL to receive webhook notifications.
    - `webhook_id` string, required — A unique webhook ID. Reference this value to modify or delete the webhook subscription. operations as well.

## Other responses

- `400` — BAD REQUEST. Request is malformed or invalid values are detected.
- `403` — FORBIDDEN. Not authorized to query webhook for this entity.
- `404` — NOT FOUND. Unable to find webhook.

## Changes

- **2026-07-31** `1f62c40558c6` — 7 warning
  - added the new `subscription_canceled` enum value to the `webhooks/items/events/items/` response property for the response status `200`
  - added the new `subscription_created` enum value to the `webhooks/items/events/items/` response property for the response status `200`
  - added the new `subscription_ended` enum value to the `webhooks/items/events/items/` response property for the response status `200`
  - added the new `subscription_paused` enum value to the `webhooks/items/events/items/` response property for the response status `200`
  - …3 more

[Change history](https://skmtc.dev/bolt/apis/bolt-api-reference/changes/v1/webhooks/get.md)

---

[API](https://skmtc.dev/bolt/apis/bolt-api-reference.md) · [All operations](https://skmtc.dev/bolt/apis/bolt-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/bolt/bolt-api-reference/revisions/1f62c40558c6/schema)