조직 목록 조회

GET /v1/organizations · 권한 organizations:read

환경의 조직을 최신순으로 나열합니다. 앞으로 이동하는 페이지네이션(after)만 지원하며, before를 보내거나 desc가 아닌 order를 보내면 422를 반환합니다. 필터는 정확히 일치하는 값으로 비교하며, 삭제된 조직은 목록에 포함되지 않습니다.

요청

필드	유형	필수 여부	설명
`limit`	integer	아니요	페이지 크기, 1-100(기본값 20).
`after`	string	아니요	이전 페이지의 `list_metadata.after` 커서입니다.
`status`	string	아니요	이 상태의 조직만 표시합니다: `active`, `disabled` 또는 `pending_deletion`.
`slug`	string	아니요	현재 slug와 정확히 일치하는 값입니다.
`external_id`	string	아니요	`external_id`와 정확히 일치하는 값입니다.
`domain`	string	아니요	아직 지원하지 않으며, `422`를 반환합니다.

요청 본문은 없습니다.

응답

200 OK와 조직 페이지를 반환합니다.

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

오류

HTTP	code	발생 조건
400	`invalid_cursor`	커서 형식이 잘못되었거나 다른 필터에 속한 커서입니다.
422	`validation_failed`	쿼리 매개변수가 잘못되었습니다(`before`, `order=asc`, `domain`, 알 수 없는 `status`).
401	`unauthenticated`	자격 증명이 없거나 잘못되었거나 취소되었습니다.
403	`insufficient_permissions`	자격 증명에 필요한 권한이 없습니다.
429	`rate_limited`	요청 한도를 초과했습니다. `Retry-After` 기간 후 다시 시도하십시오.
503	`service_unavailable`	종속 서비스를 일시적으로 사용할 수 없습니다. `Retry-After` 기간 후 다시 시도하십시오.

예시

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