---
title: "List team members profiles"
method: GET
path: "/team-member-profiles"
tags: ["Teams"]
---

# List team members profiles

`GET /team-member-profiles`

List team members profiles. You always need to specify a `team_id` that your are a member of on the client. You can always filter for your own profile by setting `me` as the `user_id` in the path parameters. If you want list all the profiles in a team, you need to have the `$read_members` permission in that team.

## Query parameters

- `user_id` string
- `team_id` string

## Response `200`

Successful response

- object
  - `items` object[], required
    - `team_id` string, required — The unique identifier of the team
    - `user_id` string, required — The unique identifier of the user
    - `display_name` 'null', nullable — Human-readable team member display name. This is not a unique identifier. Note that this is separate from the display_name of the user.
    - `profile_image_url` 'null', nullable — URL of the profile image for team member. Can be a Base64 encoded image. Must be smaller than 100KB. Please compress and crop to a square before passing in.
  - `pagination` object
    - `next_cursor` 'null', nullable — The cursor to fetch the next page of results. null if there is no next page.

## Changes

- **2026-07-23** `fc669d833a13` — 3 breaking, 3 warning
  - the response property `items/items/display_name` became nullable for the status `200`
  - the response property `items/items/profile_image_url` became nullable for the status `200`
  - the response property `pagination/next_cursor` became nullable for the status `200`
  - added the new `undefined` enum value to the `items/items/display_name` response property for the response status `200`
  - …2 more

[Change history](https://skmtc.dev/hexclave/apis/hexclave-rest-api/changes/team-member-profiles/get.md)

---

[API](https://skmtc.dev/hexclave/apis/hexclave-rest-api.md) · [All operations](https://skmtc.dev/hexclave/apis/hexclave-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/hexclave/hexclave-rest-api/revisions/86dcd8c9953c/schema)