List calendars
Namespace: microsoft.graph
Get all the user's calendars (/calendars
navigation property), get the calendars from the default calendar group or from a specific calendar group.
Permissions
One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.
Permission type | Permissions (from least to most privileged) |
---|---|
Delegated (work or school account) | Calendars.Read, Calendars.Read.Shared, Calendars.ReadWrite |
Delegated (personal Microsoft account) | Calendars.Read, Calendars.Read.Shared, Calendars.ReadWrite |
Application | Calendars.Read, Calendars.ReadWrite |
HTTP request
All the user's calendars.
GET /me/calendars
GET /users/{id | userPrincipalName}/calendars
The user's calendars in a specific calendarGroup.
GET /me/calendarGroups/{calendar_group_id}/calendars
GET /users/{id | userPrincipalName}/calendarGroups/{calendar_group_id}/calendars
Optional query parameters
This method supports the OData Query Parameters to help customize the response.
Request headers
Header | Value |
---|---|
Authorization | Bearer {token}. Required. |
Content-Type | application/json |
Request body
Do not supply a request body for this method.
Response
If successful, this method returns a 200 OK
response code and collection of Calendar objects in the response body.
Example
Request
The following is an example of a request.
GET https://graph.microsoft.com/v1.0/me/calendars
Response
The following is an example of the response.
Note: The response object shown here might be shortened for readability.
HTTP/1.1 200 OK
Content-type: application/json
{
"@odata.context": "https://graph.microsoft.com/v1.0/$metadata#me/calendars",
"value": [
{
"@odata.id": "https://graph.microsoft.com/v1.0/users('ddfcd489-628b-40d7-b48b-57002df800e5@1717622f-1d94-4d0c-9d74-709fad664b77')/calendars('AAMkAGI2TGuLAAA=')",
"id": "AAMkAGI2TGuLAAA=",
"name": "Calendar",
"color": "auto",
"changeKey": "nfZyf7VcrEKLNoU37KWlkQAAA0x0+w==",
"canShare":true,
"canViewPrivateItems":true,
"hexColor": "",
"canEdit":true,
"allowedOnlineMeetingProviders": [
"teamsForBusiness"
],
"defaultOnlineMeetingProvider": "teamsForBusiness",
"isTallyingResponses": true,
"isRemovable": false,
"owner":{
"name":"Samantha Booth",
"address":"samanthab@adatum.onmicrosoft.com"
}
}
]
}
Feedback
Submit and view feedback for