---
title: "Get team members by ids"
method: POST
path: "/api/v4/teams/{team_id}/members/ids"
tags: ["teams"]
---

# Get team members by ids

`POST /api/v4/teams/{team_id}/members/ids`

Get a list of team members based on a provided array of user ids.
##### Permissions
Must have `view_team` permission for the team.

## Path parameters

- `team_id` string, required

## Request body

- string[]

## Response `200`

Team members retrieval successful

- 38cb7293TeamMember[]
  - `team_id` string — The ID of the team this member belongs to.
  - `user_id` string — The ID of the user this member relates to.
  - `roles` string — The complete list of roles assigned to this team member, as a space-separated list of role names, including any roles granted implicitly through permissions schemes.
  - `delete_at` integer — The time in milliseconds that this team member was deleted.
  - `scheme_user` boolean — Whether this team member holds the default user role defined by the team's permissions scheme.
  - `scheme_admin` boolean — Whether this team member holds the default admin role defined by the team's permissions scheme.
  - `explicit_roles` string — The list of roles explicitly assigned to this team member, as a space separated list of role names. This list does *not* include any roles granted implicitly through permissions schemes.

## Other responses

- `400` — Invalid or missing parameters in URL or request body
- `401` — No access token provided
- `403` — Do not have appropriate permissions

---

[API](https://skmtc.dev/infomaniak/apis/api-reference-developer-tools.md) · [All operations](https://skmtc.dev/infomaniak/apis/api-reference-developer-tools/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/infomaniak/api-reference-developer-tools/revisions/667aae28fec6/schema)