# List employees

**GET /employers/{employerId}/employees**

Retrieve a paginated list of employees for a specified employer.


## Servers
- Production: https://partner-api.getpenfold.com/v1 (Production)
- Staging: https://partner-api.getpenfold.dev/v1 (Staging)


## Authentication methods
- Bearer auth


## Parameters

### Path parameters
- **employerId** (string(uuid))
  Penfold employer UUID

### Query parameters
- **pageSize** (integer)
  The maximum number of employees to return per page.
- **pageNumber** (integer)
  The page number to return.


## Responses
### 200
A paginated list of employees for the specified employer.

#### Body: application/json (object)
- **pageNumber** (integer)
  The current page number.
- **pageSize** (integer)
  The number of items per page.
- **totalItems** (integer)
  The total number of items available.
- **items** (array[object])
  An array of Employee objects on the current page.

### 400
Request body failed validation

#### Body: application/json (object)
- **error** (string)
  A descriptive error message.
- **validationErrors** (array[object])


### 401
Missing or invalid authentication token

#### Body: application/json (object)
- **error** (string)


### 404
Resource not found

#### Body: application/json (object)
- **error** (string)


### 500
Internal server error

#### Body: application/json (object)
- **error** (string)



[Powered by Bump.sh](https://bump.sh)