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

---

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