---
title: "List webhooks for a service external ID or all webhooks"
method: GET
path: "/v1/webhook"
tags: ["Webhooks"]
---

# List webhooks for a service external ID or all webhooks

`GET /v1/webhook`

## Query parameters

- `live` boolean, required
- `service_id` string
- `gateway_account_id` string
- `override_service_id_restriction` boolean

## Response `200`

OK

- WebhookResponse[]
  - `callback_url` string
  - `created_date` string, date-time
  - `description` string
  - `external_id` string
  - `gateway_account_id` string
  - `live` boolean
  - `service_id` string
  - `status` 'ACTIVE' | 'INACTIVE'
  - `subscriptions` string[]

## Other responses

- `400` — For invalid query params

## Changes

- **2023-05-23** `12636419a51a` — 1 info
  - added the new optional `query` request parameter `gateway_account_id`
- **2023-05-18** `985d887f3aff` — 1 info
  - added the optional property `items/gateway_account_id` to the response with the `200` status
- **2022-10-28** `f2c3e257ae9d` — 2 warning
  - added the new `card_payment_expired` enum value to the `items/subscriptions/items/` response property for the response status `200`
  - added the new `card_payment_failed` enum value to the `items/subscriptions/items/` response property for the response status `200`

[Change history](https://skmtc.dev/government-digital-service/apis/webhooks-api/changes/v1/webhook/get.md)

---

[API](https://skmtc.dev/government-digital-service/apis/webhooks-api.md) · [All operations](https://skmtc.dev/government-digital-service/apis/webhooks-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/government-digital-service/webhooks-api/revisions/c08d1ac8dcab/schema)