> ## 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 Credit Use History

> Returns a paged history of how all members of a team used their booking time, money credit and printing credit, with filter options.

# Get Team Credit Use History

Returns a paged list of the benefit uses of **every member of the team**: booking time, money credit and printing credit, plus a row for credit lost when a benefit expired with credit left. It covers every member's benefits, shared with the team or not, as the team **Benefits** page in the Nexudus dashboard does. The portal uses it for the **Booking time and credit use history** section of the team [Benefits](https://learn.nexudus.com/member-portal/teams/team-management.md#team-benefits) page.

The records have the same fields as [Get Customer Credit Use History](https://learn.nexudus.com/api/endpoints/coworkers/customer-benefits-history.md). Passes are not included.

## 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

**kind** `string`

The kind of benefit to return: `"BookingTime"`, `"Credit"` or `"Printing"` (case-insensitive). Leave it out to return every kind together. Any
other value returns `400 Bad Request`.

**benefit** `string`

Only return uses of benefits with this name. Use a value from `Filters.Benefits[].Name`.

**coworkerId** `number`

Only return uses by this team member. Use a value from `Filters.Members[].Id`.

**page** `number` (default: 1)

Page number, starting at 1.

**size** `number` (default: 25)

Number of records per page.

**\_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

A standard paged list plus the filter options, sorted by `IssuedFor`, then `UsedFromUtc`, both newest first. There is no date limit. See
[Get Customer Credit Use History](https://learn.nexudus.com/api/endpoints/coworkers/customer-benefits-history.md#response) for the fields of each record.

**Records** `BenefitUsageRecord[]` *required*

The uses on the requested page. `UsedById` and `UsedByFullName` say which team member used each benefit.

**Filters.Benefits** `array`

Every benefit with at least one use, as `{ Name, Kind }`. Built before any filter is applied.

**Filters.Members** `array`

Every team member with at least one use, as `{ Id, FullName }`. Built before any filter is applied.

## Example Request

```
GET /api/public/teams/42/benefits/history?kind=Credit&coworkerId=1042&page=1&size=25
```

## Usage in Portal

| Context | Source file |
| - | - |
| Data hook (`scope: "team"`) | `src/views/user/plans/useBenefitUsageHistoryData.ts` |
| History section component | `src/views/user/plans/components/BenefitUsageHistorySection.tsx` |

## Error Responses

**400 Bad Request** `error`

`kind` is not `BookingTime`, `Credit` or `Printing`.

**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`](https://learn.nexudus.com/api/endpoints/teams/team-benefits) | Current benefits of all members of a team |
| `GET` | [`/api/public/coworkers/profiles/current/benefits/history`](https://learn.nexudus.com/api/endpoints/coworkers/customer-benefits-history) | Credit use history of the current customer |


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