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

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_ 接頭辞が付きます。

{
  "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 依存先が一時的に利用できません。後でリトライしてください。

例

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

個人データ

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