# Employee Sub-Resource Endpoints {#employee-sub-resource-endpoints}


API endpoints for employee awards, levels, settings, statistics, and recurring expenses.


## Employee Awards {#employee-awards}



### Base Path: `/api/employee-award` {#base-path-apiemployee-award}


```
GET    /api/employee-award                # List awards
GET    /api/employee-award/:id            # Get award
POST   /api/employee-award                # Create award
PUT    /api/employee-award/:id            # Update award
DELETE /api/employee-award/:id            # Delete award
```

**Create Body:**

```json
{
  "name": "Employee of the Month",
  "year": "2025",
  "employeeId": "employee-uuid"
}
```


## Employee Levels {#employee-levels}



### Base Path: `/api/employee-level` {#base-path-apiemployee-level}


```
GET    /api/employee-level                # List levels
POST   /api/employee-level                # Create level
PUT    /api/employee-level/:id            # Update level
DELETE /api/employee-level/:id            # Delete level
```

**Create Body:**

```json
{
  "level": "Senior",
  "tag": [{ "id": "tag-uuid" }]
}
```


## Employee Settings {#employee-settings}



### Base Path: `/api/employee-setting` {#base-path-apiemployee-setting}


Per-employee configuration, such as time tracking preferences.

```
GET    /api/employee-setting              # List settings
GET    /api/employee-setting/:id          # Get setting
POST   /api/employee-setting              # Create setting
PUT    /api/employee-setting/:id          # Update setting
DELETE /api/employee-setting/:id          # Delete setting
```


## Employee Statistics {#employee-statistics}



### Base Path: `/api/employee-statistics` {#base-path-apiemployee-statistics}


Read-only aggregate statistics.

```
GET /api/employee-statistics/months
GET /api/employee-statistics/count
GET /api/employee-statistics/statistics
```

**Statistics Response:**

```json
{
  "totalWorkHours": 160.5,
  "totalIncome": 8500,
  "totalExpenses": 1200,
  "totalBonuses": 500
}
```


## Employee Recurring Expenses {#employee-recurring-expenses}



### Base Path: `/api/employee-recurring-expense` {#base-path-apiemployee-recurring-expense}


```
GET    /api/employee-recurring-expense                # List
GET    /api/employee-recurring-expense/:id            # Get by ID
POST   /api/employee-recurring-expense                # Create
PUT    /api/employee-recurring-expense/:id            # Update
DELETE /api/employee-recurring-expense/:id            # Delete
GET    /api/employee-recurring-expense/employee/:id   # By employee
```

**Create Body:**

```json
{
  "categoryName": "Insurance",
  "value": 500,
  "currency": "USD",
  "startDate": "2025-01-01",
  "employeeId": "employee-uuid"
}
```


## Employee Recent Visits {#employee-recent-visits}



### Base Path: `/api/employee-recent-visit` {#base-path-apiemployee-recent-visit}


Track recently visited entities for quick access.

```
GET    /api/employee-recent-visit             # List recent visits
POST   /api/employee-recent-visit             # Record visit
DELETE /api/employee-recent-visit/:id         # Delete visit
```


## Employee Notification Settings {#employee-notification-settings}



### Base Path: `/api/employee-notification-setting` {#base-path-apiemployee-notification-setting}


```
GET    /api/employee-notification-setting                  # Get settings
POST   /api/employee-notification-setting                  # Create settings
PUT    /api/employee-notification-setting/:id              # Update settings
```


## Related Pages {#related-pages}


- [Employee Endpoints](https://sourcey-gauzy.pages.dev/api/employee-endpoints/index.md) — main employee API
- [Employee Management](https://sourcey-gauzy.pages.dev/features/employee-management/index.md) — feature guide
- [Employee Entities](https://sourcey-gauzy.pages.dev/database/entity-reference/employee-entities/index.md) — DB schema