> ## Documentation Index
> Fetch the complete documentation index at: https://learn.nexudus.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Team Benefits

> Returns the current benefits of all members of a team: booking credits, booking time, printing credits and passes.

# Get Team Benefits

Returns the current benefits of **every member of the team**, whether or not they are shared with the team. This matches the team **Benefits** page in the Nexudus dashboard. The portal uses it for the **Current benefits** section of the team [Benefits](https://learn.nexudus.com/member-portal/teams/team-management.md#team-benefits) page.

The response has the same shape as [`GET /api/public/coworkers/profiles/current/benefits`](https://learn.nexudus.com/api/endpoints/coworkers/customer-benefits): the team's benefits are in `Team`, and `Personal` is always empty.

## Authentication

Requires a valid customer bearer token. The customer must be a team administrator of the specified team.

## Path Parameters

**teamId** `number` *required*

Numeric identifier of the team. Returned as `Id` from [`GET /api/public/teams/my`](https://learn.nexudus.com/api/endpoints/teams/list-teams).

## Query Parameters

**depletedLast** `boolean` (default: false)

When `true`, fully used benefits that are still valid move to the end of each list, and the rest keep their order. See
[Get Customer Benefits](https://learn.nexudus.com/api/endpoints/coworkers/customer-benefits.md) for when a benefit counts as fully used. Expired benefits are never
returned.

**\_shape** `string`

Comma-separated list of field paths to include in the response. When provided, only the
specified fields are returned — useful for reducing payload size. Supports nested paths
using dot notation.

## Response

**Personal** `object`

Always empty: `BookingCredits`, `ExtraServices` and `TimePasses` are empty arrays.

**Team.BookingCredits** `array`

Booking credits of all team members. Same fields as `Personal.BookingCredits` in
[Get Customer Benefits](https://learn.nexudus.com/api/endpoints/coworkers/customer-benefits.md), with `Kind` always `"Credit"`.

**Team.ExtraServices** `array`

Booking time and printing credits of all team members. `Kind` is `"Printing"` for printing credits, otherwise `"BookingTime"`.

**Team.TimePasses** `array`

Passes of all team members, with `Kind` always `"Pass"`.

**Team.\*.Coworker** `object`

The team member who owns the benefit, on every booking credit, extra service and pass: `Id` and `FullName` only. The portal shows
it in the **Member** column of the team's current benefits.

## Example Request

```
GET /api/public/teams/42/benefits?depletedLast=true
```

## Usage in Portal

| Context | Source file |
| - | - |
| Data hook (with `teamId`) | `src/views/user/plans/useMyBenefitsData.ts` |
| Team Benefits page | `src/views/user/team/benefits/TeamBenefitsSection.tsx` |

## Error Responses

**401 Unauthorized** `error`

The bearer token is missing, expired, or invalid, or the customer is not a team administrator of this team.

**404 Not Found** `error`

No team exists with this `teamId`.

## Related Endpoints

| Method | Endpoint | Description |
| - | - | - |
| `GET` | [`/api/public/teams/{teamId}/benefits/history`](https://learn.nexudus.com/api/endpoints/teams/team-benefits-history) | Credit use history of all members of a team |
| `GET` | [`/api/public/coworkers/profiles/current/benefits`](https://learn.nexudus.com/api/endpoints/coworkers/customer-benefits) | Current benefits of the current customer |
| `GET` | [`/api/public/teams/my`](https://learn.nexudus.com/api/endpoints/teams/list-teams) | Teams of the current customer |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.