---
title: "List organization users in a zone"
method: GET
path: "/zones/{zoneId}/members"
tags: ["Zone Members"]
---

# List organization users in a zone

`GET /zones/{zoneId}/members`

Lists all organization users in a zone with their roles and metadata. Supports cursor-based pagination.

## Path parameters

- `zoneId` string, required

## Query parameters

- `limit` integer
- `after` string
- `before` string
- `expand[]` union
  - 'total_count'
  - string[]
- `role` union
  - 'zone_manager'
  - 'zone_viewer'

## Response `200`

Default Response

- object
  - `items` IamZoneMember[], required
    - `id` string, required — Unique identifier of the zone member
    - `organization_user_id` string, required — Organization user ID of the zone member
    - `zone_id` string, required — Zone ID the organization user is a member of
    - `organization_id` string, required — Organization ID that owns the zone
    - `role` 'zone_manager' | 'zone_viewer', required — Zone role type. zone_manager has full management access, zone_viewer has read-only access.
    - `created_at` string, date-time, required — Entity creation timestamp
    - `updated_at` string, date-time, required — Entity update timestamp
    - `_links` IamZoneMemberLinks, required — HAL-format hypermedia links for zone member resources
      - `self` object, required
        - `href` string, uri-reference, required — Link to this zone member resource
      - `organization_user` object, required
        - `href` string, uri-reference, required — Link to the user resource
  - `page_info` IamPageInfo, required — Pagination information
    - `has_next_page` boolean, required — Whether there are more items after the current page
    - `has_previous_page` boolean, required — Whether there are items before the current page
    - `start_cursor` string, nullable — Cursor pointing to the first item in the current page
    - `end_cursor` string, nullable — Cursor pointing to the last item in the current page
  - `pagination` IamPagination, required — Cursor-based pagination metadata
    - `after_cursor` string, required — An opaque cursor used for paginating through a list of results
    - `before_cursor` string, required — An opaque cursor used for paginating through a list of results
    - `total_count` integer — Total number of items matching the query. Only included when expand[]=total_count is requested.

## Other responses

- `default` — Error response

## Changes

- **2026-03-16** `d3d69f45bfed` — 3 info
  - the endpoint scheme security `OAuth2` was added to the API
  - the endpoint scheme security `bearerAuth` was added to the API
  - the endpoint scheme security `iam_bearerAuth` was removed from the API
- **2026-03-09** `cb43483cd1b3` — 2 info
  - added the new optional `query` request parameter `expand[]`
  - added the required property `pagination` to the response with the `200` status

[Change history](https://skmtc.dev/keycardai/apis/untitled-api/changes/zones/:zoneId/members/get.md)

---

[API](https://skmtc.dev/keycardai/apis/untitled-api.md) · [All operations](https://skmtc.dev/keycardai/apis/untitled-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/keycardai/untitled-api/revisions/d65d51379d93/schema)