---
title: "ListWebhooks"
method: GET
path: "/registry/{registry_ref}/webhooks"
tags: ["Webhooks"]
---

# ListWebhooks

`GET /registry/{registry_ref}/webhooks`

Returns List of Webhook Details

## Path parameters

- `registry_ref` string, required

## Query parameters

- `page` integer
- `size` integer
- `sort_order` string
- `sort_field` string
- `search_term` string

## Response `200`

response for list webhooks

- object
  - `status` 'SUCCESS' | 'FAILURE' | 'ERROR', required — Indicates if the request was successful or not
  - `data` ListWebhooks, required — A list of Harness Registries webhooks
    - `pageCount` integer — The total number of pages
    - `itemCount` integer — The total number of items
    - `pageSize` integer — The number of items per page
    - `pageIndex` integer — The current page
    - `webhooks` Webhook[], required — A list of Registries webhooks
      - `version` integer
      - `identifier` string, required
      - `name` string, required
      - `description` string
      - `url` string, required
      - `createdAt` string
      - `createdBy` integer
      - `modifiedAt` string
      - `enabled` boolean, required
      - `internal` boolean
      - `secretIdentifier` string
      - `secretSpacePath` string
      - `secretSpaceId` integer
      - `insecure` boolean, required
      - `triggers` Trigger[]
      - `latestExecutionResult` 'SUCCESS' | 'RETRIABLE_ERROR' | 'FATAL_ERROR' — refers to webhook execution
      - `extraHeaders` ExtraHeader[]
        - `key` string, required
        - `value` string, required
        - `masked` boolean

## Other responses

- `400` — Bad request
- `401` — Unauthenticated
- `403` — Unauthorized
- `500` — Internal server error

## Changes

- **2025-12-12** `fc6dc4501402` — 1 info
  - added the optional property `data/webhooks/items/extraHeaders/items/masked` to the response with the `200` status
- **2025-03-24** `c55e0097ca2a` — 1 info
  - removed the `ARTIFACT_MODIFICATION` enum value from the `data/webhooks/items/triggers/items/` response property for the response status `200`
- **2025-03-11** `b3c2e43cf388` — 2 info
  - the response property `data/webhooks/items/extraHeaders/items/key` became required for the status `200`
  - the response property `data/webhooks/items/extraHeaders/items/value` became required for the status `200`
- **2025-01-23** `2eaa14ea6ba2` — 1 info
  - endpoint added
- **2024-10-23** `7fa72da6b8aa` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/harness/apis/harness-artifact-registry-api/changes/registry/:registry_ref/webhooks/get.md)

---

[API](https://skmtc.dev/harness/apis/harness-artifact-registry-api.md) · [All operations](https://skmtc.dev/harness/apis/harness-artifact-registry-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/harness/harness-artifact-registry-api/revisions/e315ed26a2f1/schema)