
# ユーザーの紐付け済みアイデンティティを一覧表示

`GET /v1/users/{user_id}/identities` · 権限 `users:read`

ユーザーに紐付けられたアイデンティティ（パスワード、ソーシャル、SAML、OIDC、レガシー）を 1 ページで一覧表示し、作成日時順に並べます。ユーザーあたりのアイデンティティ数には上限があるため、一覧には `limit`、`after`、`before`、`order` がなく、`list_metadata` は常に値が `null` です。アイデンティティの外部 subject（OIDC の `sub`、SAML の NameID）、ID プロバイダから報告されたメールアドレス、認証情報の参照は返されません。パスキーとワンタイムコードの方式は認証器であり、`GET /v1/users/{user_id}/authenticators` で一覧表示されます。

## リクエスト

| パラメータ | 場所 | 必須 | 説明 |
|---|---|---|---|
| `user_id` | path | はい | ユーザー ID。接頭辞は `usr_`。 |

## レスポンス

`200 OK`。`data` にはアイデンティティが作成日時順に入ります。一覧はページングされないため、`list_metadata` は常に値が `null` です。`connection_id` は `password` の場合 `null` です。`provider` は `social` の場合のみ設定されます。

アイデンティティ ID には `idn_` 接頭辞が付きます。

```json
{
  "data": [
    {
      "id": "idn_0a1b2c3d4e5f6g7h8j9k0m1n2q",
      "type": "password",
      "connection_id": null,
      "provider": null,
      "linked_via": "primary",
      "created_at": "2026-01-15T09:30:00Z"
    },
    {
      "id": "idn_0a1b2c3d4e5f6g7h8j9k0m1n2r",
      "type": "social",
      "connection_id": "conn_0a1b2c3d4e5f6g7h8j9k0m1n2s",
      "provider": "google",
      "linked_via": "manual_link",
      "created_at": "2026-02-01T08:00:00Z"
    }
  ],
  "list_metadata": {
    "before": null,
    "after": null
  }
}
```

`type`: `password`, `social`, `saml`, `oidc`, `legacy` · `linked_via`: `primary`, `auto_verified_email`, `user_confirmed`, `admin_api`, `import`, `jit`, `auto_domain`, `invite_proof`, `manual_link`, `scim_match`

## エラー

すべてのエラーは、安定した `code` を含む `application/problem+json` 本文です。

| HTTP | `code` | 発生条件 |
|---|---|---|
| 404 | `not_found` | この環境にユーザーが存在しない（または ID の形式が不正）。 |
| 401 | `unauthenticated` | API キーがないか、無効または取り消されています。 |
| 403 | `insufficient_permissions` | キーに `users:read` 権限がありません。 |
| 429 | `rate_limited` | レート制限を超えました。`Retry-After` に従ってください。 |
| 503 | `service_unavailable` | 依存先が一時的に利用できません。後でリトライしてください。 |

## 例

```bash
curl https://api.eu.keenauth.com/v1/users/usr_0a1b2c3d4e5f6g7h8j9k0m1n2p/identities \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"
```

## 個人データ

このエンドポイントは個人データ（紐付けされたアイデンティティ）を扱います。[KeenAuth API における個人データ](/docs/policies/personal-data)では、保存される内容、保持期間、削除方法を説明しています。いかなるフィールドにも、特別な種類の個人データ（健康、生体データ、宗教、政治的意見、性的指向）を送信しないでください。
