---
title: "Get a list of new team members."
method: GET
path: "/api/v4/teams/{team_id}/top/team_members"
tags: ["insights"]
---

# Get a list of new team members.

`GET /api/v4/teams/{team_id}/top/team_members`

Get a list of all of the new team members that have joined the given team during the given time period.
##### Permissions
Must have `view_team` permission for the team.

## Path parameters

- `team_id` string, required

## Query parameters

- `time_range` string, required
- `page` integer
- `per_page` integer

## Response `200`

New team members retrieved successfully.

- 38cb7293NewTeamMembersList
  - `has_next` boolean — Indicates if there is another page of new team members that can be fetched.
  - `items` 38cb7293NewTeamMember[] — List of new team members.
    - `id` string — The user's ID.
    - `username` string
    - `first_name` string
    - `last_name` string
    - `nickname` string
    - `position` string — The user's position field value.
    - `create_at` integer — The creation timestamp of the team member record.
  - `total_count` integer — The total count of new team members for the given time range.

## Other responses

- `400` — Invalid or missing parameters in URL or request body
- `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/158a854b0c7d/schema)