# サポートアクセス許可を一覧表示

`GET /v1/support-access-grants` · 権限 `support-access-grants:read`

この環境が KeenAuth サポート担当者に与えた期限付きアクセスを新しい順に一覧表示します。前方ページネーション (`after`) のみ対応し、`before` および `desc` 以外の `order` は `422` を返します。`status` はその状態の許可のみを返します。`expired` は取り消されておらず `expires_at` を過ぎた許可です。

## リクエスト

| フィールド | タイプ | 必須 | 説明 |
|---|---|---|---|
| `limit` | integer | いいえ | ページサイズ、1-100 (既定 20)。 |
| `after` | string | いいえ | 前のページの `list_metadata.after` カーソル。 |
| `status` | string | いいえ | この状態の許可のみ: `active`、`revoked`、`expired`。 |

リクエストボディはありません。

## レスポンス

許可のページを含む `200 OK`。

```json
{
  "data": [
    {
      "id": "sag_01j9xk3m7q8r2s4t6v8w0y2z4a",
      "scope": "read",
      "status": "active",
      "ticket_ref": "SUP-48213",
      "allowed_regions_of_staff": ["eu"],
      "granted_by": "du_01j9xk2p5n7q9s1t3v5w7y9z1b",
      "created_at": "2026-10-12T09:30:00.123456Z",
      "expires_at": "2026-10-13T09:30:00.123456Z",
      "revoked_at": null
    }
  ],
  "list_metadata": {
    "before": null,
    "after": null
  }
}
```

## エラー

| HTTP | コード | 概要 |
|---|---|---|
| 400 | `invalid_cursor` | カーソルの形式が不正か、別のフィルターのものです。 |
| 422 | `validation_failed` | クエリパラメーターが無効です (`before`、`order=asc`、不明な `status`)。 |
| 403 | `insufficient_permissions` | 認証情報に必要な権限がありません。 |
| 401 | `unauthenticated` | 認証情報がない、無効、または失効しています。 |
| 429 | `rate_limited` | レート制限を超えました。`Retry-After` の時間が経過してから再試行してください。 |
| 503 | `service_unavailable` | 依存サービスが一時的に利用できません。`Retry-After` の時間が経過してから再試行してください。 |

## 例

```bash
curl "https://api.eu.keenauth.com/v1/support-access-grants?status=active&limit=20" \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"
```