---
title: "List organization members"
method: POST
path: "/v1/organizations/{organizationId}/members/list"
tags: ["Organization"]
---

# List organization members

`POST /v1/organizations/{organizationId}/members/list`

## Request

- Base URL: `https://api.timesheet.io`
- URL: `https://api.timesheet.io/v1/organizations/{organizationId}/members/list`
- Auth: one of:
  - HTTP bearer
  - API key in header `Authorization`

Retrieves a paginated list of all members (users) within a specific organization with their permission details. Supports filtering by status (active/deleted) and searching by name or email. The user must have permission to view the organization's members.

## Path parameters

- `organizationId` string, required

## Request body

- OrganizationMemberListParams
  - `search` string
  - `sort` string
  - `order` string
  - `count` integer
  - `page` integer
  - `limit` integer
  - `deleted` boolean
  - `offset` integer

## Response `200`

List of members

- OrganizationMemberList
  - `items` OrganizationMemberDto[]
    - `id` string
    - `user` string
    - `email` string
    - `firstname` string
    - `lastname` string
    - `imageUrl` string
    - `deleted` boolean
    - `invited` boolean
    - `permission` OrganizationPermissionDto
      - `invoicing` boolean
      - `billing` boolean
      - `admin` boolean
    - `teamAssignments` OrganizationMemberTeamAssignmentDto[]
      - `teamMemberId` string
      - `teamId` string
      - `teamName` string
      - `employeeId` string
      - `deleted` boolean
      - `permission` TeamPermissionDto
        - `role` string
        - `managerOrOwner` boolean
        - `owner` boolean
        - `manager` boolean
        - `member` boolean
      - `projectRegistrations` TeamMemberProjectRegistrationDto[]
        - `projectId` string
        - `permission` ProjectPermissionDto
          - `role` string
          - `managerOrOwner` boolean
          - `owner` boolean
          - `manager` boolean
          - `member` boolean
      - `lastUpdate` integer
      - `created` integer
    - `hasActiveContract` boolean
    - `hasLicense` 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

- `401`: Not authorized
- `403`: Invalid permission (e.g., not part of the organization)

---

[API](https://skmtc.dev/timesheet/apis/timesheet-api.md) - [All operations](https://skmtc.dev/timesheet/apis/timesheet-api/llms.txt) - [OpenAPI document](https://skmtc.dev/timesheet/apis/timesheet-api/revisions/2f6595c95dc4?raw)