# Bir kuruluşun üyelerini listele

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

Bir kuruluşun üyeliklerini, son değişikliğe göre sıralanmış olarak listeler; bir kuruluş profili ekranı için kullanılır. Bekleyen davetler burada görünmez. Her satır kullanıcıyı yalnızca `usr_…` tanımlayıcısıyla belirtir; bu uç nokta ad veya e-posta adresi döndürmez. Kimliği doğrulanmış kullanıcının `__Host-idp_session` çerezi gerekir; çerez yoksa, süresi dolmuşsa veya iptal edilmişse `401 unauthenticated` döner. Farklı bir kökenden gelen birinci taraf bir uygulama bunun yerine ön uç API erişim belirtecini gönderebilir (`Authorization: DPoP <token>` ve bir DPoP kanıtı ile; bkz. [Ön uç API erişim belirteci](/docs/api/fapi/front-api-token)). Kullanıcının kuruluşun etkin bir üyesi olması ve `idp_members:read` iznine sahip olması gerekir. Üye olmayan bir kullanıcı `404 not_found` alır; izni olmayan bir üye `403 insufficient_permissions` alır.

`@keenauth/js` ile: `await keenauth.organizations.members(orgId, { status: "active" })`.

## İstek

Üstbilgiler:

| Üstbilgi | Zorunlu | Açıklama |
| --- | --- | --- |
| `Idp-Client` | evet | SDK tanımlayıcısı. |

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

Sorgu parametreleri:

| Parametre | Zorunlu | Açıklama |
| --- | --- | --- |
| `status` | hayır | `active`, `suspended` veya `removed`; atlandığında üçü de. |
| `role_id` | hayır | Yalnızca bu rolü (`rol_…`) taşıyan üyelikler. |
| `after` | hayır | Önceki sayfanın `next_after` değeri (opak). |
| `limit` | hayır | 1–100, varsayılan 20. |

Gövde yok.

## Yanıt

`200 OK` ile `{"data": [...], "next_after": "..."}`; `next_after` son sayfada bulunmaz.

Her öğe: `id` (`mem_…`), `user_id` (`usr_…`), `status`, `roles` (her biri `role_id` ve atamanın nereden geldiğini gösteren `source` ile birlikte, örneğin `admin_api` veya `default`), `created_at`, `activated_at` (veya `null`), `expires_at` (veya `null`), `updated_at`, `version`.

## Hatalar

| Durum | Kod | Ne zaman |
| --- | --- | --- |
| 400 | `invalid_cursor` | `after` hatalı biçimlendirilmişse. |
| 401 | `unauthenticated` | Geçerli bir oturum çerezi yoksa. |
| 403 | `insufficient_permissions` | Kullanıcının kuruluşta `idp_members:read` izni yoksa. |
| 404 | `not_found` | Bu kullanıcı için böyle bir kuruluş yoksa; bilinmeyen, hatalı biçimlendirilmiş veya başkasına ait tanımlayıcı aynı yanıtı verir. |
| 422 | `validation_failed` | `status`, `role_id` veya `limit` geçersizse. |
| 503 | `service_unavailable` | Geçici olarak kullanılamıyor; `Retry-After` değerinden sonra yeniden deneyin. |

## Örnek

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

## Kişisel veriler

Bu uç nokta kişisel veri içerir: kuruluş üyelikleri ve davetler. [KeenAuth API'lerinde kişisel veriler](/docs/policies/personal-data) sayfası neyin saklandığını, ne kadar süre tutulduğunu ve nasıl silindiğini açıklar. Hiçbir alanda özel nitelikli kişisel verileri (sağlık, biyometrik veriler, din, siyasi görüşler, cinsel yönelim) göndermeyin.