# 自分の組織の提案を一覧表示

`GET /fapi/v1/me/organization-suggestions` · サインインホストから呼び出されます

認証済みユーザーの確認済みメールアドレスのドメインに基づき、そのユーザーが参加を招待されている組織を一覧表示します。組織は、有効であり、そのドメインをドメインキャプチャ`suggest`に設定して確認済みであり、かつユーザーがそのメンバーではない場合に提案されます（削除済みまたは脱退済みのメンバーシップも対象に含まれるため、再度提案されることはありません）。組織は 1 件につき 1 項目が、スラッグ順に最大 20 件返されます。ユーザーが 3 回却下した組織は一覧に表示されません。環境のデフォルトのメンバーロールがドメインキャプチャで付与できないもの（管理者ロール、特権ロール、組織とそのメンバーの読み取りを超えるシステム権限を持つロール）の場合、一覧は空になります。読み取り操作は何も変更せず、最近確認されたセッションも必要ありません。認証済みユーザーの `__Host-idp_session` Cookie が必要です。Cookie がない、期限切れ、または取り消されている場合は `401 unauthenticated` を返します。別のオリジンにある自社のファーストパーティアプリは、代わりにフロント API アクセストークン（DPoP 証明付きの `Authorization: DPoP <token>`）を送信できます。[フロント API アクセストークン](/docs/api/fapi/front-api-token) を参照してください。

`@keenauth/js` を指定すると: `await keenauth.organizations.suggestions()`。

## リクエスト

ヘッダー:

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

クエリパラメータはありません。リクエストボディもありません。

## レスポンス

`200 OK` と `{"data": [...]}` を返します。レスポンスはキャッシュされません（`Cache-Control: no-store`）。

各項目: `id`（`odm_…`、確認済みドメインのレコード。参加または却下に使用します）、`domain`（一致したメールアドレスのドメイン）、および `organization` と `id`（`org_…`）、`slug` と `name`（制御文字と双方向文字を除いた表示名。組織に名前がない場合はスラッグ。プレーンテキストとして表示してください）。

## エラー

| ステータス | コード | 発生条件 |
| --- | --- | --- |
| 401 | `unauthenticated` | 有効なセッション Cookie もフロント API アクセストークンもない。 |
| 503 | `temporarily_unavailable` | メンバーシップディレクトリが応答しなかった。後で再試行してください。 |

## 例

```bash
curl https://example.keenauth.app/fapi/v1/me/organization-suggestions \
  -H "Idp-Client: my-app/1.0.0 (node/22.0.0)" \
  -b cookies.txt
```

```json
{
  "data": [
    {
      "id": "odm_01j9a5c4000000000000000001",
      "domain": "acme.example",
      "organization": {
        "id": "org_01j9xxxxxxxxxxxxxxxxxxxxxx",
        "slug": "acme",
        "name": "Acme"
      }
    }
  ]
}
```

## 個人データ

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