Skip to main content

event list

Retrieves a list of events from a specific calendar of a user.

Usage​

m365 outlook event list [options]

Options​

--userId [userId]

ID of the user. Specify either userId or userName, but not both.

--userName [userName]

UPN of the user. Specify either userId or userName, but not both.

--calendarId [calendarId]

ID of the calendar. Specify either calendarId or calendarName, but not both.

--calendarName [calendarName]

Name of the calendar. Specify either calendarId or calendarName, but not both.

--startDateTime [startDateTime]

Time indicating the inclusive start of a time range when the event starts.

--endDateTime [endDateTime]

Time indicating the exclusive end of a time range when the event starts.

--timeZone [timeZone]

The time zone for the event start and end times.

--properties [properties]

Comma-separated list of properties to retrieve.

--filter [filter]

OData filter to apply when retrieving the events.

-h, --help [help]

Output usage information. Optionally, specify which section of command's help you want to see. Allowed values are options, examples, remarks, permissions, response, full. Default is options.

--query [query]

JMESPath query string. See http://jmespath.org/ for more information and examples.

-o, --output [output]

Output type. json, text, csv, md, none. Default json.

--verbose

Runs command with verbose logging.

--debug

Runs command with debug logging.

Remarks​

info

When you specify a value for timeZone, consider the options of the time zone list, or additional time zone list

Permissions​

ResourcePermissions
Microsoft GraphCalendars.ReadBasic, Calendars.Read

Examples​

List all events for the current signed-in user from a calendar specified by id.

m365 outlook event list --userId "@meId" --calendarId "AAMkAGRkZ"

List all events for the current signed-in user from a calendar specified by id and return event times in Pacific Standard Time time zone.

m365 outlook event list --userId "@meId" --calendarId "AAMkAGRkZ" --timeZone 'Pacific Standard Time'

List only id, subject, start time and end time of all events for a specific user and specific calendar

m365 outlook event list --userName "john.doe@contoso.com" --calendarName "Calendar" --properties "id,subject,start,end"

Filter events for the current signed-in user

m365 outlook event list --userId "@meId" --calendarId "AAMkAGRkZ" --filter "contains(subject, 'contoso')"

List all events from specific date range

m365 outlook event list --userId "@meId" --calendarId "AAMkAGRkZ" --startDateTime '2026-01-01' --endDateTime '2026-01-31'

Response​

[
  {
    "id": "AQMkAGRlM2Y5YTkzLWI2NzAtNDczOS05YWMyLTJhZGY2MGExMGU0MgBGAAADSG3wPE27kUeySjmT5eRT8QcAfJKVL07AC6GQ5pgAAAA==",
    "createdDateTime": "2026-03-29T13:57:47.9194633Z",
    "lastModifiedDateTime": "2026-03-29T13:59:48.6329479Z",
    "changeKey": "fJKVL07sbkmIfHqjbDnRgQAC54IeWA==",
    "categories": [],
    "transactionId": "localevent:c95ac848-7295-ad3e-ee1e-f3832b10bf3e",
    "originalStartTimeZone": "Greenwich Standard Time",
    "originalEndTimeZone": "Greenwich Standard Time",
    "iCalUId": "040000008200E00074C5B7101A82E008000000006B71750684BFDC01000000000000000010000000872F2916501A8442A7DB64D2E460E3D9",
    "uid": "040000008200E00074C5B7101A82E008000000006B71750684BFDC01000000000000000010000000872F2916501A8442A7DB64D2E460E3D9",
    "reminderMinutesBeforeStart": 15,
    "isReminderOn": true,
    "hasAttachments": false,
    "subject": "Retro",
    "bodyPreview": "Retrospective",
    "importance": "normal",
    "sensitivity": "normal",
    "isAllDay": false,
    "isCancelled": false,
    "isOrganizer": true,
    "responseRequested": true,
    "seriesMasterId": null,
    "showAs": "busy",
    "type": "singleInstance",
    "webLink": "https://outlook.office365.com/owa/?itemid=AQMkAGRlM2Y%3D%3D&exvsurl=1&path=/calendar/item",
    "onlineMeetingUrl": null,
    "isOnlineMeeting": false,
    "onlineMeetingProvider": "unknown",
    "allowNewTimeProposals": true,
    "occurrenceId": null,
    "isDraft": false,
    "hideAttendees": false,
    "responseStatus": {
      "response": "organizer",
      "time": "0001-01-01T00:00:00Z"
    },
    "body": {
      "contentType": "html",
      "content": "<html>\r\\\n<head>\r\\\n<meta http-equiv=\"Content-Type\" content=\"text/html; charset=utf-8\">\r\\\n</head>\r\\\n<body>\r\\\n<div class=\"elementToProof\" style=\"font-family:Aptos,Aptos_EmbeddedFont,Aptos_MSFontService,Calibri,Helvetica,sans-serif; font-size:12pt; color:rgb(0,0,0)\">\r\\\nRetrospective</div>\r\\\n</body>\r\\\n</html>\r\\\n"
    },
    "start": {
      "dateTime": "2026-03-29T16:00:00.0000000",
      "timeZone": "UTC"
    },
    "end": {
      "dateTime": "2026-03-29T18:00:00.0000000",
      "timeZone": "UTC"
    },
    "location": {
      "displayName": "",
      "locationType": "default",
      "uniqueIdType": "unknown",
      "address": {},
      "coordinates": {}
    },
    "locations": [],
    "recurrence": null,
    "attendees": [],
    "organizer": {
      "emailAddress": {
        "name": "John Doe",
        "address": "john.doe@contoso.com"
      }
    },
    "onlineMeeting": null
  }
]