Get task history

Get history of task changing

Function GetTaskHistory(Val URL, Val TaskID, Val Token = "") Export

Parameter	CLI option	Type	Required	Description
URL	--url	String	✔	URL of webhook or a Bitrix24 domain, when token used
TaskID	--task	Number, String	✔	Task ID
Token	--token	String	✖	Access token, when app auth method used

Returns: Map Of KeyAndValue - serialized JSON of answer from Bitrix24 API

tip

Method at API documentation: tasks.task.history.list

1C:Enterprise/OneScript code example

    URL    = "https://b24-ar17wx.bitrix24.by/rest/1/h0m...";
    TaskID = "7884";

    Result = OPI_Bitrix24.GetTaskHistory(URL, TaskID);

    URL    = "b24-ar17wx.bitrix24.by";
    Token  = "75d8c668006e9f06006b12e400000001000...";
    TaskID = "7886";

    Result = OPI_Bitrix24.GetTaskHistory(URL, TaskID, Token);

Bash

    oint bitrix24 GetTaskHistory \
     --url ""b24-ar17wx.bitrix24.by"" \
     --task ""7992"" \
     --token "***"

CMD/Bat

    oint bitrix24 GetTaskHistory ^
     --url ""b24-ar17wx.bitrix24.by"" ^
     --task ""7992"" ^
     --token "***"

Result

{
 "result": {
  "list": [
   {
    "id": 100356,
    "createdDate": "2025-09-15T22:44:50+00:00",
    "field": "NEW",
    "value": {
     "from": null,
     "to": null
    },
    "user": {
     "id": 1,
     "name": "Антон",
     "lastName": "Титовец",
     "secondName": "",
     "login": "VKuser657846756"
    }
   },
   {
    "id": 100358,
    "createdDate": "2025-09-15T22:44:53+00:00",
    "field": "START_DATE_PLAN",
    "value": {
     "from": "",
     "to": "1757976290"
    },
    "user": {
     "id": 1,
     "name": "Антон",
     "lastName": "Титовец",
     "secondName": "",
     "login": "VKuser657846756"
    }
   },
   {
    "id": 100360,
    "createdDate": "2025-09-15T22:44:53+00:00",
    "field": "END_DATE_PLAN",
    "value": {
     "from": "",
     "to": "1758056400"
    },
    "user": {
     "id": 1,
     "name": "Антон",
     "lastName": "Титовец",
     "secondName": "",
     "login": "VKuser657846756"
    }
   },
   {
    "id": 100362,
    "createdDate": "2025-09-15T22:44:53+00:00",
    "field": "DURATION_PLAN_SECONDS",
    "value": {
     "from": "",
     "to": "80110"
    },
    "user": {
     "id": 1,
     "name": "Антон",
     "lastName": "Титовец",
     "secondName": "",
     "login": "VKuser657846756"
    }
   },
   {
    "id": 100376,
    "createdDate": "2025-09-15T22:45:06+00:00",
    "field": "TITLE",
    "value": {
     "from": "New task",
     "to": "Another task title"
    },
    "user": {
     "id": 1,
     "name": "Антон",
     "lastName": "Титовец",
     "secondName": "",
     "login": "VKuser657846756"
    }
   },
   {
    "id": 100378,
    "createdDate": "2025-09-15T22:45:06+00:00",
    "field": "DESCRIPTION",
    "value": {
     "from": "",
     "to": ""
    },
    "user": {
     "id": 1,
     "name": "Антон",
     "lastName": "Титовец",
     "secondName": "",
     "login": "VKuser657846756"
    }
   },
   {
    "id": 100380,
    "createdDate": "2025-09-15T22:45:06+00:00",
    "field": "PRIORITY",
    "value": {
     "from": "2",
     "to": "1"
    },
    "user": {
     "id": 1,
     "name": "Антон",
     "lastName": "Титовец",
     "secondName": "",
     "login": "VKuser657846756"
    }
   },
   {
    "id": 100386,
    "createdDate": "2025-09-15T22:45:34+00:00",
    "field": "RESPONSIBLE_ID",
    "value": {
     "from": "1",
     "to": "2664"
    },
    "user": {
     "id": 1,
     "name": "Антон",
     "lastName": "Титовец",
     "secondName": "",
     "login": "VKuser657846756"
    }
   },
   {
    "id": 100388,
    "createdDate": "2025-09-15T22:45:35+00:00",
    "field": "COMMENT",
    "value": {
     "from": null,
     "to": "18602"
    },
    "user": {
     "id": 1,
     "name": "Антон",
     "lastName": "Титовец",
     "secondName": "",
     "login": "VKuser657846756"
    }
   },
   {
    "id": 100392,
    "createdDate": "2025-09-15T22:45:40+00:00",
...