# 組織の招待を一覧表示

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

組織プロフィール画面向けに、組織の招待を作成順に一覧表示します。保留中の招待は、`idp_members:read` も保持している場合にのみ招待先のメールアドレスが表示されます。それ以外の場合、`email` は `null` になります。承諾済み、取り消し済み、期限切れの招待にはメールアドレスは含まれません。

ログイン中のユーザーの `__Host-idp_session` Cookie、または第一者アプリのフロント API アクセストークン（DPoP 証明を添えた `Authorization: DPoP <token>`。[フロント API アクセストークン](/docs/api/fapi/front-api-token) を参照）が必要です。ユーザーは、組織の有効なメンバーであり、`idp_members:invite` 権限を持っている必要があります。メンバーでないユーザーには `404 not_found` が返され、権限のないメンバーには `403 insufficient_permissions` が返されます。

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

## リクエスト

ヘッダー:

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

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

クエリパラメーター:

| パラメーター | 必須 | 説明 |
| --- | --- | --- |
| `status` | いいえ | `pending`、`accepted`、`revoked`、`expired` のいずれか。省略時はすべてが対象になります。 |
| `after` | いいえ | 前のページの `next_after` の値。 |
| `limit` | いいえ | 1〜100。既定値は 20。 |

ボディはありません。

## レスポンス

`200 OK` で、`{"data": [...], "next_after": "..."}` が返されます。最後のページでは `next_after` は含まれません。各項目は [招待](/docs/api/fapi/organizations/invitations/create) のフィールドを持ちます。

## エラー

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

## 例

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

```json
{
  "data": [
    {
      "id": "inv_01jbz6x8kq3m2n4p5r6s7t8v9d",
      "email": "new.member@example.com",
      "role_ids": ["rol_01jbz6x8kq3m2n4p5r6s7t8v9w"],
      "delivery": "email",
      "delivery_status": "sent",
      "status": "pending",
      "send_count": 1,
      "last_sent_at": "2026-11-03T10:00:00Z",
      "expires_at": "2026-11-10T10:00:00Z",
      "accepted_user_id": null,
      "accepted_at": null,
      "revoked_at": null,
      "created_at": "2026-11-03T10:00:00Z",
      "updated_at": "2026-11-03T10:00:00Z",
      "version": 1
    }
  ],
  "next_after": "inv_01jbz6x8kq3m2n4p5r6s7t8v9d"
}
```

## 個人データ

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