# Bir kuruluşu getirin

`GET /fapi/v1/organizations/{org_id}` · ortamın oturum açma sunucusundan çağrılır

Bir kuruluşun profilini yöneticisinin gördüğü şekliyle döndürür: ad, slug, durum, marka rengi ve sürüm. Bir kuruluş profil ekranında gösterilen bilgi budur. Kimliği doğrulanmış kullanıcının `__Host-idp_session` çerezi gereklidir; çerez yoksa, süresi dolmuşsa veya iptal edilmişse `401 unauthenticated` döner. Başka bir kökendeki birinci taraf bir uygulama, bunun yerine ön yüz API erişim belirtecini gönderebilir (`Authorization: DPoP <token>` ve bir DPoP kanıtıyla; bkz. [Ön yüz API erişim belirteci](/docs/api/fapi/front-api-token)). Kullanıcı kuruluşun aktif bir üyesi olmalı ve `idp_org:read` iznine sahip olmalıdır. Üye olmayan bir kullanıcı `404 not_found` alır; böylece kuruluşun varlığı açığa çıkmaz. İzni olmayan bir üye ise `403 insufficient_permissions` alır.

`@keenauth/js` ile: `await keenauth.organizations.get(orgId)`.

## İstek

Başlıklar:

| Başlık | Zorunlu | Açıklama |
| --- | --- | --- |
| `Idp-Client` | evet | SDK tanımlayıcısı. |

`org_id`: kuruluş tanımlayıcısı (`org_…`).

Gövde yok.

## Yanıt

`ETag: "<version>"` ile birlikte `200 OK`.

| Alan | Açıklama |
| --- | --- |
| `id` | `org_…`. |
| `name` | Görünen ad; düz metin olarak gösterin. |
| `slug` | Kuruluşun slug değeri. |
| `status` | `active`, `disabled` veya `pending_deletion`. |
| `brand_color` | `#RRGGBB`, ayarlanmamışsa `null`. |
| `deletion_due_at` | Yalnızca kuruluş silinmeyi beklerken: ne zaman silineceği. |
| `created_at`, `updated_at` | RFC 3339 zamanları. |
| `version` | `ETag` içinde taşınan sürüm; bir güncellemede `If-Match` olarak gönderin. |

## Hatalar

| Durum | Kod | Ne zaman |
| --- | --- | --- |
| 401 | `unauthenticated` | Geçerli bir oturum çerezi yoksa. |
| 403 | `insufficient_permissions` | Kullanıcının kuruluşta `idp_org:read` izni yoksa. |
| 404 | `not_found` | Bu kullanıcı için böyle bir kuruluş yoksa; bilinmeyen, hatalı biçimli veya başkasına ait bir tanımlayıcı aynı yanıtı verir. |
| 503 | `service_unavailable` | Geçici olarak kullanılamıyorsa; `Retry-After` sonrası yeniden deneyin. |

## Örnek

```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
}
```