Skip to main content

Get calendar events

Gets events of calendars with or without filters

Function GetCalendarEvents(Val URL, Val OwnerID, Val Type, Val Filter = "", Val Token = "") Export

ParameterCLI optionTypeRequiredDescription
URL--urlString✔URL of webhook or a Bitrix24 domain, when token used
OwnerID--ownerString, Number✔Calendar owner ID
Type--typeString✔Calendar type: user, group, company_calendar
Filter--filterStructure Of KeyAndValue✖Events filter. See GetCalendarEventsFilterStructure
Token--tokenString✖Access token, when app auth method used

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

tip

Method at API documentation: calendar.event.get


1C:Enterprise/OneScript code example
    URL     = "https://b24-ar17wx.bitrix24.by/rest/1/av5...";
    OwnerID = 1;
    Type    = "user";

    Result = OPI_Bitrix24.GetCalendarEvents(URL, OwnerID, Type);

    URL         = "b24-ar17wx.bitrix24.by";
    Token       = "a5b00469006e9f06006b12e400000001000...";
    EventID     = "3046";
    CalendarID1 = "1648";
    CalendarID2 = "1650";

    Tomorrow = OPI_Tools.GetCurrentDate() + 86400;
    NextDay  = Tomorrow + 86400;

    ArrayOfCalendars = New Array;
    ArrayOfCalendars.Add(CalendarID1);
    ArrayOfCalendars.Add(CalendarID2);

    Filter = New Structure;
    Filter.Insert("from"   , Tomorrow);
    Filter.Insert("to"     , NextDay);
    Filter.Insert("section", ArrayOfCalendars);

    Result = OPI_Bitrix24.GetCalendarEvents(URL, OwnerID, Type, Filter, Token);
    # JSON data can also be passed as a path to a .json file
    
    oint bitrix24 GetCalendarEvents \
      --url "b24-ar17wx.bitrix24.by" \
      --owner 1 \
      --type "user" \
      --filter "{'from':'03/26/2026 06:42:38','to':'03/27/2026 06:42:38','section':['2182','2184']}" \
      --token "***"
Result
{
 "result": [
  {
   "ID": "4144",
   "PARENT_ID": "4144",
   "ACTIVE": "Y",
   "DELETED": "N",
   "CAL_TYPE": "user",
   "OWNER_ID": "1",
   "NAME": "New event",
   "DATE_FROM": "26.03.2026 09:20:00",
   "DATE_TO": "26.03.2026 10:20:00",
   "ORIGINAL_DATE_FROM": "***",
   "TZ_FROM": "Europe/Minsk",
   "TZ_TO": "Europe/Minsk",
   "TZ_OFFSET_FROM": "10800",
   "TZ_OFFSET_TO": "10800",
   "DATE_FROM_TS_UTC": "1774495206",
   "DATE_TO_TS_UTC": "1777101600",
   "DT_SKIP_TIME": "N",
   "DT_LENGTH": 3600,
   "EVENT_TYPE": null,
   "CREATED_BY": "1",
   "DATE_CREATE": "25.03.2026 12:20:06",
   "TIMESTAMP_X": "25.03.2026 12:20:06",
   "DESCRIPTION": "Event description",
   "DT_FROM": null,
   "DT_TO": null,
   "PRIVATE_EVENT": "1",
   "ACCESSIBILITY": "quest",
   "IMPORTANCE": "normal",
   "IS_MEETING": true,
   "MEETING_STATUS": "H",
   "MEETING_HOST": "1",
   "MEETING": {
    "HOST_NAME": "Антон Титовец",
    "NOTIFY": true,
    "REINVITE": "***",
    "ALLOW_INVITE": "***",
    "HIDE_GUESTS": true,
    "MEETING_CREATOR": 1,
    "LANGUAGE_ID": "ru",
    "MAIL_FROM": false
   },
   "LOCATION": "Office",
   "REMIND": [
    {
     "type": "day",
     "count": 1
    }
   ],
   "COLOR": "#230000",
   "TEXT_COLOR": "",
   "RRULE": {
    "FREQ": "DAILY",
    "COUNT": 3,
    "INTERVAL": 10,
    "UNTIL": "05.04.2026",
    "~UNTIL": "05.04.2026",
    "UNTIL_TS": 1775347200
   },
   "EXDATE": "",
   "DAV_XML_ID": "20260326T062000Z-b6e1bc12995568aee5169b09026e0717@b24-ar17wx.bitrix24.by",
   "G_EVENT_ID": "",
   "DAV_EXCH_LABEL": "",
   "CAL_DAV_LABEL": "",
   "VERSION": "1",
   "ATTENDEES_CODES": [
    "U1",
    "U10"
   ],
   "RECURRENCE_ID": null,
   "RELATIONS": "",
   "SECTION_ID": "2198",
   "SYNC_STATUS": null,
   "UF_CRM_CAL_EVENT": null,
   "UF_WEBDAV_CAL_EVENT": null,
   "SECTION_DAV_XML_ID": null,
   "DATE_FROM_FORMATTED": "Thu Mar 26 2026 09:20:00",
   "DATE_TO_FORMATTED": "Thu Mar 26 2026 10:20:00",
   "IS_DAYLIGHT_SAVING_TZ": "N",
   "SECT_ID": "2198",
   "OPTIONS": null,
   "ATTENDEE_LIST": [
    {
     "id": 1,
     "entryId": "4144",
     "status": "H"
    },
    {
     "id": 10,
     "entryId": "4146",
     "status": "Q"
    }
   ],
   "COLLAB_ID": null,
   "~RRULE_DESCRIPTION": "каждый 10-й день, от 26.03.2026 до 05.04.2026",
   "attendeesEntityList": [
    {
     "entityId": "user",
     "id": 1
    },
    {
     "entityId": "user",
     "id": 10
    }
   ],
   "~DATE_FROM": "26.03.2026 09:20:00",
   "~DATE_TO": "26.03.2026 10:20:00",
   "RINDEX": 0,
   "~USER_OFFSET_FROM": 0,
   "~USER_OFFSET_TO": 0
  },
  {
   "ID": "4148",
   "PARENT_ID": "4148",
   "ACTIVE": "Y",
   "DELETED": "N",
   "CAL_TYPE": "user",
   "OWNER_ID": "1",
   "NAME": "New event",
   "DATE_FROM": "26.03.2026 09:20:00",
   "DATE_TO": "26.03.2026 10:20:00",
   "ORIGINAL_DATE_FROM": "***",
   "TZ_FROM": "Europe/Minsk",
   "TZ_TO": "Europe/Minsk",
   "TZ_OFFSET_FROM": "10800",
   "TZ_OFFSET_TO": "10800",
   "DATE_FROM_TS_UTC": "1774495206",
   "DATE_TO_TS_UTC": "1777101600",
   "DT_SKIP_TIME": "N",
   "DT_LENGTH": 3600,
   "EVENT_TYPE": null,
   "CREATED_BY": "1",
   "DATE_CREATE": "25.03.2026 12:20:06",
   "TIMESTAMP_X": "25.03.2026 12:20:06",
   "DESCRIPTION": "Event description",
   "DT_FROM": null,
   "DT_TO": null,
   "PRIVATE_EVENT": "1",
   "ACCESSIBILITY": "quest",
   "IMPORTANCE": "normal",
   "IS_MEETING": true,
   "MEETING_STATUS": "H",
   "MEETING_HOST": "1",
   "MEETING": {
    "HOST_NAME": "Антон Титовец",
    "NOTIFY": true,
    "REINVITE": "***",
    "ALLOW_INVITE": "***",
...