# ウェブフックエンドポイントを一覧表示する

`GET /v1/webhook-endpoints` · 権限 `webhook-endpoints:read` · すべてのプラン

環境のウェブフックエンドポイントを、新しい順（`order=asc` で古い順）にカーソルページで返します。レスポンスに署名シークレットが含まれることはありません。各フィールドについては [ウェブフックエンドポイントを取得する](get.md) を参照してください。

環境で**有効**にできるエンドポイントは、次の数までです: Free 3、Startup 20、Business 20、Enterprise 50。無効なエンドポイントは数に含まれません。

## リクエスト

| フィールド | 型 | 必須 | 説明 |
|---|---|---|---|
| `limit` | query | いいえ | 1 ページあたり 1〜100 件。既定値は 20。 |
| `after` | query | いいえ | 前のページの `list_metadata.after` から取得したカーソル。 |
| `before` | query | いいえ | `list_metadata.before` から取得したカーソル。`after` と同時には指定できません。 |
| `order` | query | いいえ | `desc`（既定値）または `asc`。カーソルは、発行されたときと同じ並び順でのみ使用できます。 |

## レスポンス

`200 OK`。最後のページでは `list_metadata.after` が `null` になります。総件数は返されません。

```json
{
  "data": [
    {
      "id": "whe_01k8a3m5q7t9v1w3x5y7z9b2c4",
      "key": "crm-sync",
      "url": "https://hooks.example.com/keenauth",
      "description": "CRM sync",
      "event_types": ["user.created", "user.updated"],
      "event_schema_versions": {},
      "payload_mode": "thin",
      "status": "enabled",
      "rate_limit_per_second": 50,
      "previous_secret_expires_at": null,
      "last_success_at": "2026-10-26T09:12:00Z",
      "failing_since": null,
      "version": 1,
      "created_at": "2026-10-26T09:00:00Z",
      "updated_at": "2026-10-26T09:00:00Z"
    }
  ],
  "list_metadata": {"before": null, "after": null}
}
```

## エラー

| HTTP | code | 発生条件 |
|---|---|---|
| 400 | `invalid_cursor` | カーソルの形式が不正であるか、別の環境または別の並び順のものです。 |
| 422 | `validation_failed` | クエリパラメータが不正です（`/limit`、`/order`）。 |
| 401 | `unauthenticated` | 認証情報が欠落しているか、無効または取り消されています。 |
| 403 | `insufficient_permissions` | 認証情報に `webhook-endpoints:read` 権限がありません。 |
| 429 | `rate_limited` | レート制限を超えました。`Retry-After` の期間を待ってから再試行してください。 |
| 503 | `service_unavailable` | ウェブフックの管理機能は一時的に利用できません。`Retry-After` の期間を待ってから再試行してください。 |

## 例

```bash
curl https://api.eu.keenauth.com/v1/webhook-endpoints?limit=20 \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"
```

CLI: `keenauth webhook-endpoints list --limit 20`