# 組織を取得

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

組織の管理者が見るとおりの、組織のプロフィール（名前、スラッグ、ステータス、ブランドカラー、バージョン）を返します。組織プロフィールの画面で表示される内容です。認証済みユーザーの `__Host-idp_session` Cookie が必要です。Cookie がない、期限切れ、または取り消されている場合は `401 unauthenticated` を返します。別オリジンの自社アプリは、代わりにフロントAPIアクセストークン（DPoP 証明付きの `Authorization: DPoP <token>`。[フロントAPIアクセストークン](/docs/api/fapi/front-api-token) を参照）を送信できます。ユーザーはその組織の有効なメンバーであり、`idp_org:read` 権限を持っている必要があります。メンバーでないユーザーには `404 not_found` を返し、組織の存在を開示しません。権限のないメンバーには `403 insufficient_permissions` を返します。

`@keenauth/js` を使う場合：`await keenauth.organizations.get(orgId)`。

## リクエスト

ヘッダー：

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

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

ボディはありません。

## レスポンス

`200 OK` と `ETag: "<version>"` が返されます。

| フィールド | 説明 |
| --- | --- |
| `id` | `org_…`。 |
| `name` | 表示名。プレーンテキストとして表示してください。 |
| `slug` | 組織のスラッグ。 |
| `status` | `active`、`disabled`、または `pending_deletion`。 |
| `brand_color` | `#RRGGBB`。未設定の場合は `null`。 |
| `deletion_due_at` | 削除保留中の場合のみ：組織が削除される予定の日時。 |
| `created_at`、`updated_at` | RFC 3339 形式の日時。 |
| `version` | `ETag` に含まれるバージョン。更新時に `If-Match` として送信します。 |

## エラー

| ステータス | コード | 条件 |
| --- | --- | --- |
| 401 | `unauthenticated` | 有効なセッション Cookie がありません。 |
| 403 | `insufficient_permissions` | ユーザーにその組織での `idp_org:read` 権限がありません。 |
| 404 | `not_found` | このユーザーに対応する組織が存在しません。存在しない、形式が不正、または他の組織の識別子の場合も同じ応答になります。 |
| 503 | `service_unavailable` | 一時的に利用できません。`Retry-After` の後に再試行してください。 |

## 例

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

```json
{
  "id": "org_01jbz6x8kq3m2n4p5r6s7t8v9a",
  "name": "Acme",
  "slug": "acme",
  "status": "active",
  "brand_color": "#112233",
  "created_at": "2026-11-03T09:00:00Z",
  "updated_at": "2026-11-03T09:30:00Z",
  "version": 4
}
```