# 組織のメンバーを一覧表示

`GET /fapi/v1/organizations/{org_id}/memberships` · 環境のサインインホストから呼び出します

組織のメンバーシップを最終変更日順に一覧表示します。組織のプロフィール画面で使用します。保留中の招待は表示されません。各行のユーザーは `usr_…` 識別子のみで示され、このエンドポイントはユーザー名やメールアドレスを返しません。認証済みユーザーの `__Host-idp_session` Cookie が必要です。Cookie が存在しない、期限切れである、または取り消されている場合は `401 unauthenticated` を返します。別のオリジンにある自社アプリは、代わりにフロント API のアクセストークンを送信できます（`Authorization: DPoP <token>` と DPoP 証明書を使用します。[フロント API アクセストークン](/docs/api/fapi/front-api-token)を参照してください）。ユーザーは組織のアクティブなメンバーであり、`idp_members:read` 権限を持っている必要があります。メンバーではないユーザーには `404 not_found` を返します。権限を持たないメンバーには `403 insufficient_permissions` を返します。

`@keenauth/js` を使用する場合: `await keenauth.organizations.members(orgId, { status: "active" })`。

## リクエスト

ヘッダー:

| ヘッダー | 必須 | 説明 |
| --- | --- | --- |
| `Idp-Client` | はい | SDK の識別子です。 |

`org_id`: 組織の識別子（`org_…`）です。

クエリパラメーター:

| パラメーター | 必須 | 説明 |
| --- | --- | --- |
| `status` | いいえ | `active`、`suspended`、`removed`。省略した場合は三つすべてが対象になります。 |
| `role_id` | いいえ | このロールを持つメンバーシップのみを対象にします（`rol_…`）。 |
| `after` | いいえ | 前のページの `next_after` の値です（不透明な値）。 |
| `limit` | いいえ | 1〜100。既定値は 20 です。 |

ボディはありません。

## レスポンス

`200 OK` で `{"data": [...], "next_after": "..."}` を返します。`next_after` は最後のページでは含まれません。

各項目: `id`（`mem_…`）、`user_id`（`usr_…`）、`status`、`roles`（各 `role_id` と、ロールの割り当て元である `source` を含みます。値は `admin_api` や `default` などです）、`created_at`、`activated_at`（または `null`）、`expires_at`（または `null`）、`updated_at`、`version`。

## エラー

| ステータス | コード | 発生条件 |
| --- | --- | --- |
| 400 | `invalid_cursor` | `after` の形式が正しくありません。 |
| 401 | `unauthenticated` | 有効なセッション Cookie がありません。 |
| 403 | `insufficient_permissions` | ユーザーに組織内の `idp_members:read` がありません。 |
| 404 | `not_found` | このユーザーに対して該当する組織がありません。存在しない識別子、形式が正しくない識別子、他のユーザーの識別子に対しては、同じ応答を返します。 |
| 422 | `validation_failed` | `status`、`role_id`、`limit` のいずれかが無効です。 |
| 503 | `service_unavailable` | 一時的に利用できません。`Retry-After` の後に再試行してください。 |

## 例

```bash
curl "https://example.keenauth.app/fapi/v1/organizations/org_01jbz6x8kq3m2n4p5r6s7t8v9a/memberships?status=active&limit=2" \
  -H "Idp-Client: my-app/1.0.0 (node/22.0.0)" \
  -b cookies.txt
```

```json
{
  "data": [
    {
      "id": "mem_01jbz6x8kq3m2n4p5r6s7t8v9b",
      "user_id": "usr_01jbz6x8kq3m2n4p5r6s7t8v9c",
      "status": "active",
      "roles": [{ "role_id": "rol_01jbz6x8kq3m2n4p5r6s7t8v9w", "source": "admin_api" }],
      "created_at": "2026-11-03T09:00:00Z",
      "activated_at": "2026-11-03T09:00:00Z",
      "expires_at": null,
      "updated_at": "2026-11-03T09:00:00Z",
      "version": 1
    }
  ],
  "next_after": "AAAYQ3dAgGUBmgAAAABwAIAAAAAAAADh"
}
```

## 個人データ

このエンドポイントは個人データを扱います。組織のメンバーシップと招待が対象です。[KeenAuth API における個人データ](/docs/policies/personal-data)では、保存される内容、保管期間、削除方法を説明しています。どのフィールドにも、特別な種類の個人データ（健康、生体情報、宗教、政治的意見、性的指向）を送信しないでください。