Get users

Get users information for dialog

Parameters

Function GetUsers(Val URL, Val UserIDs, Val Token = "") Export

Parameter	CLI option	Type	Required	Description
URL	--url	String	✔	URL of webhook or a Bitrix24 domain, when token used
UserIDs	--users	Array of String, Number	✔	Usesr ID or array of users IDs
Token	--token	String	✖	Access token, when app auth method used

Returns

Map Of KeyAndValue - serialized JSON of answer from Bitrix24 API

Advanced call ?

Parameter	Description
proxy	InternetProxy or a structure with fields Protocol, Host, Port, User, Password, UseOSAuthentication
timeout	Request execution timeout
adv_response	Formats the response as a complete HTTP structure with fields code, body, and headers
retries	Number of HTTP request send attempts on 5** status codes or internal client errors
dontwait	Creates a background job and returns its data (for 1C and OneScript only)

tip

Method at API documentation: im.user.list.get

1C:Enterprise/OneScript code example

    URL          = "https://b24-ar17wx.bitrix24.by/rest/1/av5...";
    ArrayOfUsers = New Array;

    ArrayOfUsers.Add(1);
    ArrayOfUsers.Add(10);

    Result = OPI_Bitrix24.GetUsers(URL, ArrayOfUsers);

    URL     = "b24-ar17wx.bitrix24.by";
    Token   = "a5b00469006e9f06006b12e400000001000...";
    UserIDs = 10;

    Result = OPI_Bitrix24.GetUsers(URL, UserIDs, Token);

Bash

    oint bitrix24 GetUsers \
      --url "b24-ar17wx.bitrix24.by" \
      --users 10 \
      --token "***"

CMD/Bat

    oint bitrix24 GetUsers ^
      --url "b24-ar17wx.bitrix24.by" ^
      --users 10 ^
      --token "***"

Result

{
 "result": {
  "10": {
   "id": 10,
   "active": true,
   "name": "Techno Pizza",
   "first_name": "Techno",
   "last_name": "Pizza",
   "work_position": null,
   "color": "#ab7761",
   "avatar": "",
   "avatar_hr": "https://b24-ar17wx.bitrix24.by/bitrix/js/im/images/blank.gif",
   "gender": "M",
   "birthday": "",
   "extranet": false,
   "network": false,
   "bot": false,
   "connector": false,
   "external_auth_id": "socservices",
   "status": "online",
   "idle": false,
   "last_activity_date": "2024-07-13T18:36:23+00:00",
   "mobile_last_date": false,
   "desktop_last_date": false,
   "absent": false,
   "departments": [
    1,
    640
   ],
   "phones": "***",
   "bot_data": null,
   "type": "user",
   "website": "",
   "email": "iscript13@gmail.com"
  }
 },
 "time": {
  "start": 1779804795,
  "finish": 1779804795.30158,
  "duration": 0.301577091217041,
  "processing": 0,
  "date_start": "2026-05-26T14:13:15+00:00",
  "date_finish": "2026-05-26T14:13:15+00:00",
  "operating_reset_at": 1779805395,
  "operating": 0
 }
}