Skip to content

MngGetCalendarEventsByFilter

Returns calendar events for a time range. This method is designed for visible ranges loaded by calendar UI.

The manager_id filter matches an event when the manager is:

  • owner_manager_id
  • created_by
  • a participant in participants

This is how one shared meeting appears in calendars of multiple managers.

Request Data

Field Type Required Description
from time_t Yes Range start
to time_t Yes Range end
limit int Yes Maximum rows, from 1 to 50000
offset int Yes Pagination offset
deskFilter string Yes Wildcard mask over event desk
manager_id int No Owner/creator/participant manager scope
brand string No Brand namespace
customer_id int No Linked customer filter
lead_id int No Linked lead filter
login int No Linked account filter
status int No Event status
type int No Event type

deskFilter is required. DESK_* does not match events with an empty desk. Use * to include all desks, including empty desk values.

Request

{
  "command": "MngGetCalendarEventsByFilter",
  "extID": "1",
  "data": {
    "from": 1710000000,
    "to": 1710600000,
    "limit": 50000,
    "offset": 0,
    "manager_id": 10,
    "brand": "default",
    "deskFilter": "DESK_*"
  }
}

Response Data

Returns full event objects with participants. Example is shortened.

{
  "rows": [
    {
      "id": 1,
      "title": "Retention sync",
      "start_time": 1710000000,
      "end_time": 1710003600,
      "all_day": 0,
      "participants": [
        {
          "event_id": 1,
          "manager_id": 10,
          "role": 0,
          "status": 1
        },
        {
          "event_id": 1,
          "manager_id": 11,
          "role": 1,
          "status": 0
        }
      ]
    }
  ],
  "count": 1
}