---
title: "List Webhook Keys"
method: GET
path: "/v1/webhook-keys"
tags: ["webhook-security"]
---

# List Webhook Keys

`GET /v1/webhook-keys`

## Request

- Base URL: `https://api.forgeorbital.com`
- URL: `https://api.forgeorbital.com/v1/webhook-keys`
- Auth: HTTP bearer

## Response `200`

Successful Response

- WebhookKeyListResponse
  - `schema_version` 'forge-product-webhook-key-list/v2', required
  - `keys` WebhookKeyMetadataResponse[], required
    - `schema_version` 'forge-product-webhook-key/v2', required
    - `key_id` string, required
    - `description` string, nullable, required
    - `active` boolean, required
    - `lifecycle_status` 'pending' | 'active' | 'retiring' | 'revoked', required
    - `created_at` string, required
    - `activated_at` string, nullable, required
    - `retiring_at` string, nullable, required
    - `last_used_at` string, nullable, required
    - `revoked_at` string, nullable, required

## Other responses

- `default`: Stable, sanitized product API error.

---

[API](https://skmtc.dev/forgeorbital/apis/forge-decision-records-api.md) · [All operations](https://skmtc.dev/forgeorbital/apis/forge-decision-records-api/llms.txt) · [OpenAPI document](https://skmtc.dev/forgeorbital/apis/forge-decision-records-api/revisions/4410e0e5c86a?raw)