# Retrieve Staff

`GET /lokta-lms/api/v1/staff`

Returns the list of staff members.

Example Requests:

- /staff
- /staff?status=ACTIVE
- /staff?status=INACTIVE
- /staff?status=ALL

By default it Returns all the ACTIVE Staff. Otherwise a status can be provided like e.g. status=INACTIVE,
then it returns all INACTIVE staff or status=ALL returns both ACTIVE and INACTIVE staff.

## Parameters
- `officeId` (query, integer): officeId
- `staffInOfficeHierarchy` (query, boolean): staffInOfficeHierarchy
- `loanOfficersOnly` (query, boolean): loanOfficersOnly
- `status` (query, string): status

## Responses
- `default`: default response

## Response fields
- `allowedOffices` (array of OfficeData)
- `dateFormat` (string)
- `displayName` (string)
- `externalId` (string)
- `firstname` (string)
- `id` (integer)
- `isActive` (boolean)
- `isLoanOfficer` (boolean)
- `joiningDate` (string)
- `lastname` (string)
- `locale` (string)
- `mobileNo` (string)
- `officeId` (integer)
- `officeName` (string)
- `rowIndex` (integer)

## Example request (cURL)
```bash
curl -X GET \
  'http://localhost:8080/lokta-lms/api/v1/staff' \
  -u '{username}:{password}' \
  -H 'Tenant-Identifier: default'
```

## Example response
```json
[
  {
    "allowedOffices": [],
    "dateFormat": "dd MMMM yyyy",
    "displayName": "string",
    "externalId": "string"
  }
]
```

Interactive: https://developer.lokta.ai/reference.html#operation/retrieveAllStaff