---
title: "Events of resources"
canonical: "https://docs.cuesystem.com/space/TAM/871596695/Events%20of%20resources"
format: markdown
---
## Request /analytics/resourcesEvents

- **GET URL**: copy url from CUE Admin
- Parameters
  - **token**: Required autorization token from CUE Admin
  - **startDateTime** and **endDateTime**: Required. The response will return events that have a realEnd in the defined time range.
  - **pageSize**: Each request returns a collection of data of one or more events in the response. You can optionally specify this parameter to set the maximum number of events in one page of response.

### Example

```
GET https://apiDomain/analytics/resourcesEvents?token=1699ae06-93fa-46dc-a34e-ff86d5f6d938&startDateTime=2023-12-01T00:00:00Z&endDateTime=2023-12-30T00:00:00Z&pageSize=10
```

## Response specification

> ℹ️ **Value from calendar server: **This means that the value is as we get it from the calendar server.
> ℹ️ 
> ℹ️ For Microsoft365 explore their [documentation](https://learn.microsoft.com/en-us/graph/api/calendar-list-events).

- **nextLink**: If this parameter is returned, there are additional pages of data to be retrieved in the session.
- **resourcesEvents**: Each combination of resource and event is one item, one event can be in the array several times times.
  - **iCalUid**: Value iCalUid from Microsoft365
  - **seriesMasterId**: Value seriesMasterId from Microsoft365
  - **createdDateTime**: Value createdDateTime from Microsoft365
  - **lastModifiedDateTime**: Value lastModifiedDateTime from Microsoft365
  - **subject**: Value subject from Microsoft365
  - **importance**: Value importance from Microsoft365
  - **sensitivity**: Value sensitivity from Microsoft365
  - **isAllDay**: Value isAllDay from Microsoft365
  - **isCancelled**: Value isCancelled from Microsoft365
  - **showAs**: Value showAs from Microsoft365
  - **onlineMeetingProvider**: Value onlineMeetingProvider from Microsoft365
  - **recurrence**: Value recurrence from Microsoft365
  - **realStart**: The real date and time of the event start
  - **realEnd**: The real date and time of the event end
  - **plannedStart**: The planned date and time of the event start
  - **plannedEnd**: The planned date and time of the event end
  - **organizerName**: Value organizer.emailAddress.name from Microsoft365
  - **organizerEmail**: Value organizer.emailAddress.address from Microsoft365
  - **synchronisedWithCalendarServer**: Information on whether the event synchronized with the calendar server. If this value is false, the synchronization failed.
  - **methodOfCollectionAnalytics**: The analytical data collection method [described here](https://docs.cuesystem.com/space/TAM/161808385/). Can take on values api, unit.
  - **createdBy**: Information whether the event was created from the CUE Assist or from the panel or externally. Can take on the values assist, unit, api.
  - **requiredConfirmation**: Information about whether confirmation is set for the resource.
  - **confirmedBy**: Information whether the event was confirmed by user of CUE Assist or from the panel. Can take on the values assist, unit, NULL.
  - **confirmedDateTime**: Date and time of event confirmation
  - **deletedBy**: Information whether the event was created from CUE Assist or from the panel or externally. Can take on the values assist, unit, NULL.
  - **deletedDateTime**: Date and time of event deletion
  - **resourceEmail**: The resource´s email at the time of inserted item to the database
  - **resourceDisplayName**: The resource´s display name at the time of inserted item to the database
  - **resourceCapacity**: The resource´s capacity as stored in CUE Admin at the time of request
  - **resourceArea**: The resource´s area (location) as stored in CUE Admin at the time of request
  - **resourceAreaBreadcrumb**: The resource´s area (location) path as stored in CUE Admin at the time of request
  - **resourceStatusResponse**: Value response from Microsoft365
  - **sensorAnalytics**: Information about the resource occupancy recorded every minute of working hours if the unit has a sensor set. Can take on the values 0 - not occupied or the sensor wasn´t available, 1 - occupied, NULL.
  - **attendees**: List of attendees from Microsoft365
    - **name**: Value emailAddress.name from Microsoft365
    - **email**: Value emailAddress.address from Microsoft365
    - **type**: Value type from Microsoft365
    - **statusResponse**: Value status.response from Microsoft365

### Example

```
{
  "nextLink": "https://dapi.cuesystem.online/analytics/resourcesEvents?skiptoken=RFNwdAIAAQAAACM6QWxsYW5EQE0zNjV4MjE0MzU1Lm9ubWljcm9zb2Z0LmNvbSlVc2VyX2MwM2U2ZWFhLWI2YWItNDZkNy05MDViLTczZWM3ZWExZjc1NbkAAAAAAAAAAAAA",
  "resourceEvents": [
    {
      "iCalUid": "040000008200E00074C5B7101A82E0080000000000000000000000000000000000000000310000007643616C2D5569640100000031366165636331612D383831302D346636382D616331302D39613739363865333961313200",
      "seriesMasterId": "AAMkAGEwM2VlNDM1LTg4MGItNDdjZC04YzUxLTc2MzI1YjU1N2I3OABGAAAAAADBBl3Ul-a5Tom4GrpL8yt3BwANpetApabqSo4oAWUuSpsoAAAAAAENAAANpetApabqSo4oAWUuSpsoAAA9i5LkAAA=",
      "createdDateTime": "2023-05-02T18:34:14+02:00",
      "lastModifiedDateTime": "2023-05-02T18:34:14+02:00",
      "subject": "test",
      "importance": "normal",
      "sensitivity": "normal",
      "isAllDay": false,
      "isCancelled": false,
      "showAs": "tentative",
      "onlineMeetingProvider": "unknown",
      "recurrence": null,
      "realStart": "2023-12-02T18:30:00+02:00",
      "realEnd": "2023-12-02T19:00:00+02:00",
      "plannedStart": "2023-12-02T18:30:00+02:00",
      "plannedEnd": "2023-12-02T20:00:00+02:00",
      "organizerName": "Organizer Name",
      "organizerEmail": "test@test.cz",
      "synchronisedWithCalendarServer": true,
      "methodOfCollectionAnalytics": "unit",
      "createdBy": "assist",
      "requiredConfirmation": true,
      "confirmedBy": "unit",
      "confirmedDateTime": "2023-12-02T20:00:00+02:00",
      "deletedBy": "assist",
      "deletedDateTime": "2023-12-02T20:00:00+02:00",
      "resourceEmail": "room3111@touchone.eu",
      "resourceDisplayName": "Room 3111",
      "resourceCapacity": 3,
      "resourceArea": "1st floor",
      "resourceAreaBreadcrumb": "Česká republika | Stodůlky | 1st floor",
      "resourceStatusResponse": "Accept",
      "sensorAnalytics": "0101010101111111111111",
      "attendees": [
        {
          "name": "Adam Almer",
          "email": "adam.almer@touchone.eu",
          "type": null,
          "statusResponse": "none"
        }
      ]
    }
  ]
}
```