Skip to main content

Get User Managers API

Overview​

Retrieves the ordered manager reporting hierarchy (Manager 1, Manager 2, Manager 3) assigned to a subordinate employee.

  • Endpoint: /api/users/get-managers
  • Method: GET / POST
  • Access: Corporate Admin / Employee / Approving Manager

Request Body / Query Schema​

FieldTypeRequiredDescription
subordinateIdString (UUID)YesSubordinate employee user ID
companyIdString (UUID)NoOptional company ID filter

Request Body Example​

{
"subordinateId": "u1111111-1111-1111-1111-111111111111"
}

Success Response (200 OK)​

{
"success": true,
"message": "User managers retrieved successfully",
"data": [
{
"id": "umm1-uuid",
"subordinateId": "u1111111-1111-1111-1111-111111111111",
"managerId": "u2222222-2222-2222-2222-222222222222",
"managerLevel": 1,
"isPrimary": true,
"manager": {
"id": "u2222222-2222-2222-2222-222222222222",
"firstName": "Alex",
"lastName": "Manager1",
"email": "alex.m1@company.com"
}
}
]
}

Database Impact​

  • Tables: user_manager_maps, users
  • Operations: Select query ordered by managerLevel ASC.