List the calendars in the user's own calendarList

GET {{baseUrl}}/calendars/users/:userIdentifier/calendarList?maxResults=<integer>&minAccessRole=writer&pageToken=<string>&showDeleted=<boolean>&showHidden=<boolean>

Returns the calendars in the user's calendar list.

Scopes: calendar:read,calendar:read:admin

Rate Limit Label: HEAVY

Request Params

KeyDatatypeRequiredDescription
maxResultsstringThe maximum number of entries returned on one result page.
minAccessRolestringThe minimum access role for the user in the returned entries.
pageTokenstringThe token that specifies which result page to return.
showDeletedstringWhether to include deleted calendar list entries in the result.
showHiddenstringWhether to show hidden entries.

HEADERS

KeyDatatypeRequiredDescription
Acceptstring

RESPONSES

status: OK

{&quot;kind&quot;:&quot;\u003cstring\u003e&quot;,&quot;etag&quot;:&quot;\u003cstring\u003e&quot;,&quot;nextPageToken&quot;:&quot;\u003cstring\u003e&quot;,&quot;items&quot;:[{&quot;id&quot;:&quot;\u003cemail\u003e&quot;,&quot;kind&quot;:&quot;\u003cstring\u003e&quot;,&quot;etag&quot;:&quot;\u003cstring\u003e&quot;,&quot;summary&quot;:&quot;\u003cstring\u003e&quot;,&quot;description&quot;:&quot;\u003cstring\u003e&quot;,&quot;location&quot;:&quot;\u003cstring\u003e&quot;,&quot;timeZone&quot;:&quot;\u003cstring\u003e&quot;,&quot;colorId&quot;:&quot;\u003cstring\u003e&quot;,&quot;backgroundColor&quot;:&quot;\u003cstring\u003e&quot;,&quot;foregroundColor&quot;:&quot;\u003cstring\u003e&quot;,&quot;hidden&quot;:&quot;\u003cboolean\u003e&quot;,&quot;selected&quot;:&quot;\u003cboolean\u003e&quot;,&quot;accessRole&quot;:&quot;reader&quot;,&quot;defaultReminders&quot;:[{&quot;method&quot;:&quot;email&quot;,&quot;minutes&quot;:&quot;\u003cinteger\u003e&quot;},{&quot;method&quot;:&quot;popup&quot;,&quot;minutes&quot;:&quot;\u003cinteger\u003e&quot;}],&quot;defaultAllDayReminders&quot;:[{&quot;method&quot;:&quot;popup&quot;,&quot;minutes&quot;:&quot;\u003cinteger\u003e&quot;},{&quot;method&quot;:&quot;email&quot;,&quot;minutes&quot;:&quot;\u003cinteger\u003e&quot;}],&quot;notificationSettings&quot;:{&quot;notifications&quot;:[{&quot;type&quot;:&quot;agenda&quot;,&quot;method&quot;:&quot;email&quot;},{&quot;type&quot;:&quot;eventResponse&quot;,&quot;method&quot;:&quot;email&quot;}]},&quot;primary&quot;:&quot;\u003cboolean\u003e&quot;,&quot;deleted&quot;:&quot;\u003cboolean\u003e&quot;,&quot;summaryOverride&quot;:&quot;\u003cstring\u003e&quot;},{&quot;id&quot;:&quot;\u003cemail\u003e&quot;,&quot;kind&quot;:&quot;\u003cstring\u003e&quot;,&quot;etag&quot;:&quot;\u003cstring\u003e&quot;,&quot;summary&quot;:&quot;\u003cstring\u003e&quot;,&quot;description&quot;:&quot;\u003cstring\u003e&quot;,&quot;location&quot;:&quot;\u003cstring\u003e&quot;,&quot;timeZone&quot;:&quot;\u003cstring\u003e&quot;,&quot;colorId&quot;:&quot;\u003cstring\u003e&quot;,&quot;backgroundColor&quot;:&quot;\u003cstring\u003e&quot;,&quot;foregroundColor&quot;:&quot;\u003cstring\u003e&quot;,&quot;hidden&quot;:&quot;\u003cboolean\u003e&quot;,&quot;selected&quot;:&quot;\u003cboolean\u003e&quot;,&quot;accessRole&quot;:&quot;freeBusyReader&quot;,&quot;defaultReminders&quot;:[{&quot;method&quot;:&quot;email&quot;,&quot;minutes&quot;:&quot;\u003cinteger\u003e&quot;},{&quot;method&quot;:&quot;popup&quot;,&quot;minutes&quot;:&quot;\u003cinteger\u003e&quot;}],&quot;defaultAllDayReminders&quot;:[{&quot;method&quot;:&quot;popup&quot;,&quot;minutes&quot;:&quot;\u003cinteger\u003e&quot;},{&quot;method&quot;:&quot;popup&quot;,&quot;minutes&quot;:&quot;\u003cinteger\u003e&quot;}],&quot;notificationSettings&quot;:{&quot;notifications&quot;:[{&quot;type&quot;:&quot;eventChange&quot;,&quot;method&quot;:&quot;email&quot;},{&quot;type&quot;:&quot;eventResponse&quot;,&quot;method&quot;:&quot;email&quot;}]},&quot;primary&quot;:&quot;\u003cboolean\u003e&quot;,&quot;deleted&quot;:&quot;\u003cboolean\u003e&quot;,&quot;summaryOverride&quot;:&quot;\u003cstring\u003e&quot;}]}