RD Sessions

List

get

Retrieve one or multiple RD Sessions, from different sources such as RDS, VDI, and AVD.

Query parameters

SiteIdinteger · int32Optional

Site ID from which to retrieve the RD session information (optional).

Sourcestring · enumOptional

RDP Session Type

Possible values:

ServerIdinteger · int32Optional

The Host ID of the server for which to retrieve the information (optional).

ServerstringOptional

The name of the server to filter the RD Session information (optional).

Statestring · enumOptional

Session State

Possible values:

UserstringOptional

User to filter the RD Session information (optional).

IPstringOptional

IP Address to filter the RD Session information (optional).

ThemeIdinteger · int32Optional

The Theme ID for which to retrieve the information (optional).

GroupIdinteger · int32Optional

The RD Session Host Group ID for which to retrieve the RD session information (optional).

Responses

200

Success

application/json; api-version=1.0

401

Unauthorized

application/json; api-version=1.0

404

Not Found

application/json; api-version=1.0

get

HTTPcURLJavaScriptPython

GET /api/RDSession HTTP/1.1
Host: 
Accept: */*

[
  {
    "sessionID": 1,
    "ip": "text",
    "serverID": 1,
    "type": [
      "0 = Desktop",
      "1 = PublishedApps",
      "2 = Application",
      "3 = VDI",
      "4 = VDIApp",
      "5 = PC",
      "6 = PCApp",
      "7 = Admin",
      "8 = Unknown",
      "9 = RemoteApps",
      "10 = DirectRDP",
      "-1 = All"
    ],
    "user": "text",
    "themeID": 1,
    "connectionMode": [
      "0 = GatewayMode",
      "1 = DirectMode",
      "2 = GatewaySSLMode",
      "3 = DirectSSLMode",
      "4 = DirectRDPMode",
      "200 = Unknown"
    ],
    "authenticationType": [
      "0 = None",
      "1 = Credentials",
      "2 = SCard",
      "3 = SAML"
    ],
    "idleStartTime": "2025-07-08T06:57:59.350Z",
    "mfaProvider": [
      "0 = None",
      "1 = Deepnet",
      "2 = SafeNet",
      "3 = Radius",
      "4 = AzureRadius",
      "5 = DuoRadius",
      "6 = FortiRadius",
      "7 = TekRadius",
      "8 = GAuthTOTP",
      "9 = TOTP",
      "10 = MicrosoftTOTP",
      "11 = EmailOTP"
    ],
    "rfiCount": 1,
    "rfiInfoList": [
      {
        "type": [
          "0 = Unknown",
          "1 = HALBInst",
          "2 = Gateway",
          "3 = ForwardingGateway",
          "4 = HALBDevice",
          "5 = HTML5",
          "6 = Other",
          "7 = AVDGateway"
        ],
        "ip": "text"
      }
    ],
    "logonDuration": 1,
    "connectionDuration": 1,
    "authenticationDuration": 1,
    "rasPolicyLookup": 1,
    "hostPreparation": 1,
    "groupPolicyLoadTime": 1,
    "userProfileLoadTime": 1,
    "desktopLoadTime": 1,
    "logonOthersDuration": 1,
    "userProfileType": [
      "0 = Unknown",
      "1 = Others",
      "2 = UPD",
      "3 = FSLogix"
    ],
    "uxEvaluator": 1,
    "connectionQuality": [
      "0 = None",
      "1 = Poor",
      "2 = Fair",
      "3 = Good",
      "4 = Excellent"
    ],
    "latency": 1,
    "protocol": [
      "0 = Console",
      "2 = RDP",
      "10 = RDP_UDP"
    ],
    "bandwidthAvailability": 1,
    "lastReconnects": 1,
    "reconnects": 1,
    "disconnectReason": "text",
    "state": [
      "0 = Active",
      "1 = Connected",
      "2 = ConnectQuery",
      "3 = Shadow",
      "4 = Disconnected",
      "5 = Idle",
      "6 = Listen",
      "7 = Reset",
      "8 = Down",
      "9 = Init",
      "-1 = All"
    ],
    "logonTime": "2025-07-08T06:57:59.350Z",
    "sessionLength": 1,
    "idleTime": 1,
    "incomingData": 1,
    "outgoingData": 1,
    "verticalResolution": 1,
    "horizontalResolution": 1,
    "colourDepth": [
      "1 = COLOURDEPTH_4BIT",
      "2 = COLOURDEPTH_8BIT",
      "4 = COLOURDEPTH_16BIT",
      "8 = COLOURDEPTH_3BYTE",
      "16 = COLOURDEPTH_15BIT",
      "24 = COLOURDEPTH_24BIT",
      "32 = COLOURDEPTH_32BIT"
    ],
    "bandwidthUsage": 1,
    "deviceName": "text",
    "clientIPAddress": "text",
    "clientOS": "text",
    "clientOSVersion": "text",
    "clientVersion": "text",
    "source": [
      "1 = RDS",
      "2 = VDI",
      "63 = AVD",
      "-1 = All"
    ],
    "vmid": "text",
    "vmName": "text",
    "sessionHostId": "text",
    "sessionHostName": "text",
    "poolName": "text",
    "templateName": "text",
    "fsLogixReasonCode": [
      "0 = ProfileAttached",
      "1 = NotInWhiteList",
      "2 = InBlackList",
      "3 = LocalProfileExists",
      "4 = ProfileShortSid",
      "5 = Unknown"
    ],
    "fsLogixStatusCode": [
      "0 = Success",
      "1 = Error",
      "2 = VirtualDiskDLL",
      "3 = GetUser",
      "5 = Security",
      "6 = VHDPath",
      "7 = CreateDir",
      "8 = Impersonation",
      "9 = CreateVHD",
      "10 = CloseHandle",
      "11 = OpenVHD",
      "12 = AttachVHD",
      "13 = GetPhysicalPath",
      "14 = OpenDevice",
      "15 = InitializeDisk",
      "16 = GetVolumeGUID",
      "17 = FormatVolume",
      "18 = GetProfileDirectory",
      "19 = SetMountPoint",
      "20 = RegistryImport",
      "21 = CheckGroupMembership",
      "22 = HandleProfile",
      "23 = ProfileSubfolderRedirection",
      "100 = WaitingCreationOfUserProfile",
      "200 = InProgress",
      "300 = AlreadyAttached"
    ]
  }
]