# 接続一覧

`GET /v1/connections` · 権限 `connections:read`

認証情報が属する環境の接続を、作成日時の新しい順にカーソルページで一覧表示します。環境は常に認証情報から取得されます。他の環境の接続が返されることはありません。`type` または `status` を変更すると、別のフィルターで発行されたカーソルは無効になります（`400 invalid_cursor`）。

## リクエスト

クエリパラメーター:

| フィールド | 型 | 必須 | 説明 |
|---|---|---|---|
| `limit` | integer | いいえ | 1〜100。既定値は 20 です。 |
| `after / before` | string | いいえ | `list_metadata` から取得する不透明なカーソルです。同時に指定できません。 |
| `order` | string | いいえ | 作成日時による `asc` または `desc`（既定値）です。 |
| `type` | string | いいえ | 接続の種類で絞り込みます（例: `social`）。 |
| `status` | string | いいえ | ステータスで絞り込みます: `active` または `inactive`。 |

## レスポンス

`200 OK` と、`data`（接続）および `list_metadata`（`before`、`after`）を返します。その方向にそれ以上ページがない場合、値は `null` になります。総件数は返されません。

```json
{
  "data": [{
      "id": "conn_0k3v8m1q2x9dz4h7s5t6w0y1ab",
      "key": "google",
      "type": "social",
      "strategy": "google",
      "name": "Google",
      "display_name": "Sign in with Google",
      "status": "inactive",
      "org_id": null,
      "allowed_email_domains": [],
      "allow_external_domains": false,
      "jit_mode": null,
      "email_trust": null,
      "default_role_ids": [],
      "trust_idp_mfa": null,
      "allow_idp_initiated": null,
      "idp_initiated_default_application_id": null,
      "idp_initiated_allowed_application_ids": [],
      "settings": {},
      "created_at": "2026-10-05T09:30:00.123456Z",
      "updated_at": "2026-10-05T09:30:00.123456Z"
    }],
  "list_metadata": { "before": null, "after": "<cursor>" }
}
```

## エラー

| HTTP | code | 発生条件 |
|---|---|---|
| 400 | `invalid_cursor` | カーソルの形式が不正か、別のフィルターで発行されています。 |
| 422 | `validation_failed` | クエリパラメーターが無効です。 |
| 401 | `unauthenticated` | 認証情報が指定されていないか、無効か、取り消されています。 |
| 403 | `insufficient_permissions` | 認証情報に必要な権限がありません。 |
| 429 | `rate_limited` | レート制限を超えました。`Retry-After` の期間を待ってから再試行してください。 |
| 503 | `service_unavailable` | 依存先サービスが一時的に利用できません。`Retry-After` の期間を待ってから再試行してください。 |

## 例

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