---
title: "Get User Leave Groups"
method: GET
path: "/LeaveRequests/Groups/User"
tags: ["Leaverequests"]
---

# Get User Leave Groups

`GET /LeaveRequests/Groups/User`

**Requires permission:** *StaffMember*

Get a list of leave groups for a specific user

## Query parameters

- `page` integer, required
- `pageSize` integer, required
- `includes` string[], nullable
- `sort` string, nullable
- `filter` string, nullable

## Response `200`

Success - Success

- GetUserLeaveGroupsResponse
  - `groups` LeaveGroupWithAdmin[]
    - `id` integer
    - `name` string
    - `description` string, nullable
    - `createdAt` string, date-time
    - `isActive` boolean
    - `members` LeaveGroupMember[]
      - `id` integer
      - `groupId` integer
      - `employeeEmail` string
      - `createdAt` string, date-time
      - `isAdmin` boolean
      - `employee` MicrosoftUser
        - `@odata.context` string, nullable
        - `id` string, guid, nullable
        - `accountEnabled` boolean
        - `manager` MicrosoftUser — recursive
        - `businessPhones` string[], nullable
        - `city` string, nullable
        - `createdDateTime` string, date-time
        - `companyName` string, nullable
        - `department` string, nullable
        - `displayName` string, nullable
        - `jobTitle` string, nullable
        - `mail` string, nullable
        - `mailNickname` string, nullable
        - `mobilePhone` string, nullable
        - `onPremisesDistinguishedName` string, nullable
        - `officeLocation` string, nullable
        - `onPremisesDomainName` string, nullable
        - `onPremisesImmutableId` string, nullable
        - `onPremisesLastSyncDateTime` string, date-time
        - `onPremisesSamAccountName` string, nullable
        - `onPremisesSyncEnabled` boolean
        - `onPremisesUserPrincipalName` string, nullable
        - `otherMails` string[], nullable
        - `passwordPolicies` string, nullable
        - `refreshTokensValidFromDateTime` string, date-time
        - `usageLocation` string, nullable
        - `userType` string, nullable
        - `assignedLicenses` AssignedLicense[], nullable
          - `disabledPlans` string[], nullable
          - `skuId` string, nullable
        - `assignedPlans` AssignedPlan[], nullable
          - `assignedDateTime` string, date-time
          - `capabilityStatus` string, nullable
          - `service` string, nullable
          - `servicePlanId` string, nullable
        - `authorizationInfo` AuthorizationInfo
          - `certificateUserIds` unknown[], nullable
            - unknown
        - `deviceKeys` DeviceKey[], nullable
          - `deviceId` string, nullable
          - `keyMaterial` string, nullable
          - `keyType` string, nullable
        - `identities` Identity[], nullable
          - `signInType` string, nullable
          - `issuer` string, nullable
          - `issuerAssignedId` string, nullable
        - `onPremisesExtensionAttributes` OnPremisesExtensionAttributes
          - `extensionAttribute1` string, nullable
          - `extensionAttribute2` string, nullable
          - `extensionAttribute3` string, nullable
          - `extensionAttribute4` string, nullable
          - `extensionAttribute5` string, nullable
          - `extensionAttribute6` string, nullable
          - `extensionAttribute7` string, nullable
          - `extensionAttribute8` string, nullable
          - `extensionAttribute9` string, nullable
          - `extensionAttribute10` string, nullable
          - `extensionAttribute11` string, nullable
          - `extensionAttribute12` string, nullable
          - `extensionAttribute13` string, nullable
          - `extensionAttribute14` string, nullable
          - `extensionAttribute15` string, nullable
        - `onPremisesProvisioningErrors` unknown[], nullable
          - unknown
        - `provisionedPlans` ProvisionedPlan[], nullable
          - `capabilityStatus` string, nullable
          - `provisioningStatus` string, nullable
          - `service` string, nullable
        - `givenName` string, nullable
        - `surname` string, nullable
        - `userPrincipalName` string, nullable
        - `photo` string, nullable
        - `canBeMasqueraded` boolean
    - `toilTypes` LeaveToilType[]
      - `id` integer
      - `name` string, nullable
      - `department` string, nullable
      - `rate` number, double, nullable
      - `hidden` boolean
      - `groupId` integer, nullable
    - `isAdmin` boolean
  - `meta` Meta
    - `page` integer
    - `pageSize` integer
    - `total` integer

## Other responses

- `400` — An Error Occurred - Explain Error
- `401` — Unauthorized
- `403` — Forbidden

---

[API](https://skmtc.net/tonbridge/apis/tonbridge-app-api.md) · [All operations](https://skmtc.net/tonbridge/apis/tonbridge-app-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tonbridge/tonbridge-app-api/versions/fab57bf5558a/schema)