---
title: "List webhook signing keys"
method: GET
path: "/api/policy/v1/enterprises/{enterpriseId}/webhooks/keys"
tags: ["Webhook Keys"]
---

# List webhook signing keys

`GET /api/policy/v1/enterprises/{enterpriseId}/webhooks/keys`

Lists all webhook signing keys registered for an enterprise.

**Authorization:** Caller must be an admin of the specified enterprise.

Returns key metadata only — actual public key material and JWK data are not included in the response.

## Path parameters

- `enterpriseId` string, required

## Query parameters

- `status` 'ACTIVE' | 'REVOKED'
- `limit` integer
- `prevId` integer

## Response `200`

A paginated list of webhook signing keys.

- ListWebhookKeysResponse — Paginated list of webhook signing keys for an enterprise.
  - `keys` WebhookKeyInfo[], required
    - `id` string, uuid, required — Internal UUID of the key.
    - `keyId` string, required — Customer-provided key identifier.
    - `keyName` string, required — Human-readable name for the key.
    - `algorithm` 'EdDSA' | 'ECDSA', nullable — The signing algorithm (EdDSA or ECDSA). Null for JWKS URI registrations.
    - `status` 'ACTIVE' | 'REVOKED', required — Current status of the key.
    - `createdDate` string, date-time, required — When the key was registered.
    - `createdBy` string, required — User who registered the key.
  - `total` integer, required — Total number of keys matching the query.
  - `limit` integer, required — Maximum results per page.
  - `prevId` integer, required — The pagination offset used in this request.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — The specified resource was not found
- `500` — Server Error - Transient error please try again

---

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