---
title: "List members"
method: GET
path: "/api/projects/{projectId}/members"
tags: ["Member"]
---

# List members

`GET /api/projects/{projectId}/members`

Retrieve a paginated list of all members in a project, including their user details and group assignments.

## Path parameters

- `projectId` string, uuid, required

## Query parameters

- `search` string
- `page` number
- `perPage` number

## Response `200`

Paginated list of project members

- object — Paginated list of project members
  - `results` object[], required — List of project members
    - `id` string, uuid, required — Unique identifier of the member
    - `owner` boolean — Whether the member is an owner of the project
    - `userId` string, uuid — User ID of the member
    - `projectId` string, uuid — Project ID the member belongs to
    - `user` object — User details of the member
      - `id` string, uuid, required — Unique identifier of the user
      - `email` string, email, required — Email address of the user
      - `firstName` string, nullable, required — First name of the user
      - `lastName` string, nullable, required — Last name of the user
      - `type` string, required — Type of user (e.g., OWNER, ADMIN, MEMBER)
      - `status` string, required — Status of the user (e.g., ACTIVE, INACTIVE)
      - `organisationId` string, uuid, required — Organisation the user belongs to
      - `isService` boolean — Whether this is a service account
      - `createdAt` string, required — Timestamp when the user was created
      - `updatedAt` string, required — Timestamp when the user was last updated
    - `groups` object[] — Groups the member belongs to
      - `id` string, uuid, required — Unique identifier of the group
      - `name` string, required — Name of the group
      - `description` string, nullable — Description of the group
      - `projectId` string, uuid, required — Project the group belongs to
      - `permissions` string[], nullable, required — List of permissions assigned to the group
      - `roleId` string, uuid, nullable — Role ID associated with the group
    - `createdAt` string, required — Timestamp when the member was created
    - `updatedAt` string, required — Timestamp when the member was last updated
  - `paginate` object, required — Pagination metadata
    - `current` number, required — Current page number
    - `from` number, required — Starting record number on the current page
    - `to` number, required — Ending record number on the current page
    - `total` number, required — Total number of records
    - `pageSize` number, required — Number of records per page

---

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