Kuruluşları listele

GET /v1/organizations · izin organizations:read

Ortamın kuruluşlarını en yenisi başta olacak şekilde listeler. Yalnızca ileri sayfalama (after) desteklenir; before ve desc dışındaki bir order değeri 422 döndürür. Filtreler tam eşleşme yapar; silinmiş kuruluşlar listelenmez.

İstek

Alan Tür Zorunlu Açıklama
limit tamsayı hayır Sayfa boyutu, 1-100 (varsayılan 20).
after metin hayır Önceki sayfanın list_metadata.after imleci.
status metin hayır Yalnızca bu durumdaki kuruluşlar: active, disabled veya pending_deletion.
slug metin hayır Mevcut slug ile tam eşleşme.
external_id metin hayır external_id ile tam eşleşme.
domain metin hayır Henüz desteklenmiyor; 422 döndürür.

İstek gövdesi yok.

Yanıt

200 OK ile kuruluşlardan oluşan bir sayfa döner.

{
  "data": [
    {
      "id": "org_01j9xk3m7q8r2s4t6v8w0y2z4a",
      "name": "Acme Corp",
      "slug": "acme",
      "external_id": "crm-4821",
      "status": "active",
      "metadata": {
        "tier": "gold"
      },
      "brand_color": "#1F6FEB",
      "max_memberships": null,
      "default_zoneinfo": null,
      "created_via": "admin_api",
      "disabled_at": null,
      "deletion_requested_at": null,
      "deletion_due_at": null,
      "created_at": "2026-10-12T09:30:00.123456Z",
      "updated_at": "2026-10-12T09:30:00.123456Z",
      "version": 1
    }
  ],
  "list_metadata": {
    "before": null,
    "after": null
  }
}

Hatalar

HTTP code Ne zaman
400 invalid_cursor İmleç bozuk veya başka filtrelere ait.
422 validation_failed Bir sorgu parametresi geçersiz (before, order=asc, domain, tanımsız status).
401 unauthenticated Kimlik bilgisi eksik, geçersiz veya iptal edilmiş.
403 insufficient_permissions Kimlik bilgisinin gerekli izni yok.
429 rate_limited Hız sınırı aşıldı; Retry-After süresinden sonra yeniden deneyin.
503 service_unavailable Bir bağımlılık geçici olarak kullanılamıyor; Retry-After süresinden sonra yeniden deneyin.

Örnek

curl "https://api.eu.keenauth.com/v1/organizations?status=active&limit=20" \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"