# Users

Represents User entities within the Property Management System (PMS), managing authentication, authorisation, and role-based access control. Users can include property managers, front desk staff, housekeeping teams, administrators, and external partners, each with specific permissions and roles. This functionality enables secure access management, user activity tracking, and assignment of responsibilities within the PMS. User entities store essential details such as usernames, roles, contact information, and access privileges, ensuring proper security measures and operational control. The Users API facilitates user creation, role management, authentication, and administrative oversight.

## Search for User entities

 - [GET /api/v3/users](https://apidocs.resharmonics.com/apis/resharmonics-pms/users/searchusers.md): This endpoint allows searching for user entities based on various criteria such as username, first name, and last name. It returns a paginated list of user projections in JSON format. The search parameters are optional and can be combined to narrow down the search results.

## Retrieve user entity by id

 - [GET /api/v3/users/{id}](https://apidocs.resharmonics.com/apis/resharmonics-pms/users/finduser.md): This endpoint retrieves a user entity based on the provided user ID. It returns the user details in JSON format. The user ID must be specified in the URL path.