---
title: "Get colleagues"
method: POST
path: "/v1/teams/getColleagues"
tags: ["Team"]
---

# Get colleagues

`POST /v1/teams/getColleagues`

Retrieves a list of colleagues (other team members) for the current user across all their teams, or filtered by a specific team. Used for user selection in UI components. Supports pagination and search.

## Request body

- TeamMemberListParams
  - `search` string
  - `sort` string
  - `order` string
  - `count` integer
  - `page` integer
  - `limit` integer
  - `organizationId` string
  - `status` string
  - `teamId` string
  - `projectId` string
  - `withoutMe` boolean
  - `withoutProjectMembers` boolean
  - `lastActivity` boolean
  - `deleted` boolean
  - `userIds` string[]
  - `withoutUserIds` string[]
  - `offset` integer

## Response `200`

Paginated list of colleague profiles

- ColleagueList
  - `items` Member[]
    - `uid` string
    - `firstname` string
    - `lastname` string
    - `email` string
    - `employeeId` string
    - `imageUrl` string
    - `deleted` boolean
    - `activity` Activity
      - `projectId` string
      - `projectTitle` string
      - `projectColor` integer
      - `taskId` string
      - `startDateTime` string
      - `endDateTime` string
      - `location` string
      - `running` boolean
    - `displayName` string
    - `initials` string
  - `params` TeamMemberListParams
    - `search` string
    - `sort` string
    - `order` string
    - `count` integer
    - `page` integer
    - `limit` integer
    - `organizationId` string
    - `status` string
    - `teamId` string
    - `projectId` string
    - `withoutMe` boolean
    - `withoutProjectMembers` boolean
    - `lastActivity` boolean
    - `deleted` boolean
    - `userIds` string[]
    - `withoutUserIds` string[]
    - `offset` integer

## Other responses

- `401` — Not authorized to view colleagues

---

[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/revisions/fbe59bacb638/schema)