---
title: "List project members"
method: POST
path: "/v1/projects/{projectId}/members/list"
tags: ["Project"]
---

# List project members

`POST /v1/projects/{projectId}/members/list`

Retrieves a paginated list of members associated with a specific project. Supports filtering by status and search terms. The response includes each member's user ID, role, permissions, and salary rates (if visible based on permissions). Project members can have different roles such as owner, manager, or member, with corresponding permission levels. The authenticated user must have at least member-level access to the project to view its members.

## Path parameters

- `projectId` string, required

## Request body

- ProjectMemberListParams
  - `search` string
  - `sort` string
  - `order` string
  - `count` integer
  - `page` integer
  - `limit` integer
  - `projectId` string
  - `status` string
  - `withoutMe` boolean
  - `userIds` string[]
  - `withDeleted` boolean
  - `offset` integer

## Response `200`

Paginated list of project members

- ProjectMemberList
  - `items` ProjectMemberDto[]
    - `id` string
    - `projectId` string
    - `teamId` string
    - `user` string
    - `email` string
    - `firstname` string
    - `lastname` string
    - `imageUrl` string
    - `deleted` boolean
    - `permission` ProjectPermissionDto
      - `role` string
      - `manager` boolean
      - `owner` boolean
      - `member` boolean
      - `managerOrOwner` boolean
    - `lastUpdate` integer
    - `created` integer
    - `displayName` string
    - `initials` string
  - `params` ListParams
    - `search` string
    - `sort` string
    - `order` string
    - `count` integer
    - `page` integer
    - `limit` integer
    - `offset` integer

## Other responses

- `400` — Invalid project ID format
- `401` — Authentication required
- `403` — Insufficient permissions to view project members
- `404` — Project not found or has been deleted

---

[API](https://skmtc.net/timesheet/apis/timesheet-api.md) · [All operations](https://skmtc.net/timesheet/apis/timesheet-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/timesheet/timesheet-api/versions/fbe59bacb638/schema)