Outlook Calendar: List Calendars with Pagination
See more Outlook Calendar Examples
List calendars accessible through the signed-in user's /me/calendars collection and display the ID, name, default-calendar flag, editability, and owner. Save the calendar ID to select a particular calendar; names need not be unique. canEdit helps explain access but is not a substitute for authorization. A shared calendar must be available to the user; this is not an inventory of every mailbox in a tenant.
Least delegated permission: Calendars.ReadBasic. Calendar IDs are opaque, case-sensitive strings. Calendar containers already have stable IDs; the event-specific ImmutableId preference is unnecessary here.
Follows each @odata.nextLink without editing its opaque query parameters. The example restricts continuation URLs to the configured Graph host, disables redirects, detects repeated links, and stops at a 100-page demonstration limit. Save the next URL privately to resume larger scans. A page can be empty and still have a next link.
Uses Microsoft Graph v1.0 in the global cloud with a delegated access token saved by the calendar OAuth2 example. Both personal Outlook.com accounts and Microsoft 365 work/school accounts with a mailbox can use this flow. The app registration must support the selected account type. A token for SMTP/IMAP/POP or another API is not a Graph token.
/me means the signed-in user and requires delegated authentication. An unattended Microsoft 365 service instead needs application permissions and administrator consent, and addresses an explicit mailbox through /users/{id-or-userPrincipalName}. That client-credentials flow does not apply to personal Outlook.com accounts. These samples target the global cloud; national clouds use different authority and Graph hosts.
HTTP methods can return false for an HTTP error as well as a connection failure. The code distinguishes those cases and checks the expected status before reading JSON. For 401, refresh the access token or authorize again; for 403, check permissions, mailbox access, and tenant policy. For 429, honor Retry-After before a bounded retry. Do not automatically repeat a write after an uncertain outcome. Keep detailed errors and calendar data private.
Chilkat Go Downloads
success := false
// Assumes Chilkat is unlocked. See Global Unlock Sample.
success = false
// Obtain a delegated Microsoft Graph token using the calendar authorization example.
// See Authorize Outlook Calendar with OAuth2 and PKCE.
token := chilkat.NewJsonObject()
token.SetStrict(true)
success = token.LoadFile("qa_data/tokens/outlookCalendar.json")
if success != true {
fmt.Println("Could not read the private calendar token cache.")
token.DisposeJsonObject()
return
}
if (token.JsonTypeOf("access_token") != 1) || (token.StringOfEquals("access_token","",true) == true) {
fmt.Println("Expected a nonempty access_token in the JSON.")
token.DisposeJsonObject()
return
}
http := chilkat.NewHttp()
http.SetAuthToken(token.StringOf("access_token"))
http.SetRequireSslCertVerify(true)
http.SetFollowRedirects(false)
http.SetConnectTimeout(20)
http.SetReadTimeout(30)
http.SetRequestHeader("Accept","application/json")
resp := chilkat.NewHttpResponse()
result := chilkat.NewJsonObject()
result.SetStrict(true)
var url *string = new(string)
*url = "https://graph.microsoft.com/v1.0/me/calendars?$select=id,name,isDefaultCalendar,canEdit,owner&$top=50"
nextLink := chilkat.NewStringBuilder()
seenLinks := chilkat.NewStringArray()
pageCount := 0
for (pageCount < 100) {
// Use Microsoft's nextLink exactly as returned; do not rebuild skip tokens.
nextLink.Clear()
nextLink.Append(*url)
if nextLink.StartsWith("https://graph.microsoft.com/v1.0/",true) != true {
fmt.Println("Unexpected pagination host or API version; no request sent.")
token.DisposeJsonObject()
http.DisposeHttp()
resp.DisposeHttpResponse()
result.DisposeJsonObject()
nextLink.DisposeStringBuilder()
seenLinks.DisposeStringArray()
return
}
if seenLinks.Find(*url,0) >= 0 {
fmt.Println("Repeated pagination URL; stopping.")
token.DisposeJsonObject()
http.DisposeHttp()
resp.DisposeHttpResponse()
result.DisposeJsonObject()
nextLink.DisposeStringBuilder()
seenLinks.DisposeStringArray()
return
}
seenLinks.Append(*url)
success = http.HttpNoBody("GET",*url,resp)
// A false result can still include an HTTP error response.
if (success != true) && (resp.StatusCode() == 0) {
fmt.Println("No HTTP response was received. Inspect diagnostics privately; reconcile a write before retrying.")
token.DisposeJsonObject()
http.DisposeHttp()
resp.DisposeHttpResponse()
result.DisposeJsonObject()
nextLink.DisposeStringBuilder()
seenLinks.DisposeStringArray()
return
}
if resp.StatusCode() != 200 {
fmt.Println("Unexpected HTTP status: ", resp.StatusCode())
fmt.Println("Request ID: ", *resp.GetHeaderField("request-id"))
if resp.StatusCode() == 429 {
fmt.Println("Retry-After: ", *resp.GetHeaderField("Retry-After"))
}
if resp.StatusCode() == 401 {
fmt.Println("Refresh the Graph access token or authorize again.")
}
token.DisposeJsonObject()
http.DisposeHttp()
resp.DisposeHttpResponse()
result.DisposeJsonObject()
nextLink.DisposeStringBuilder()
seenLinks.DisposeStringArray()
return
}
success = result.Load(resp.BodyStr())
if success != true {
fmt.Println("Expected a well-formed JSON response.")
token.DisposeJsonObject()
http.DisposeHttp()
resp.DisposeHttpResponse()
result.DisposeJsonObject()
nextLink.DisposeStringBuilder()
seenLinks.DisposeStringArray()
return
}
if result.JsonTypeOf("value") != 4 {
fmt.Println("Expected a value array.")
token.DisposeJsonObject()
http.DisposeHttp()
resp.DisposeHttpResponse()
result.DisposeJsonObject()
nextLink.DisposeStringBuilder()
seenLinks.DisposeStringArray()
return
}
i := 0
for (i < result.SizeOfArray("value")) {
result.SetI(i)
if (result.JsonTypeOf("value[i].id") != 1) || (result.StringOfEquals("value[i].id","",true) == true) {
fmt.Println("Expected a nonempty value[i].id in the JSON.")
token.DisposeJsonObject()
http.DisposeHttp()
resp.DisposeHttpResponse()
result.DisposeJsonObject()
nextLink.DisposeStringBuilder()
seenLinks.DisposeStringArray()
return
}
fmt.Println("Calendar ID: ", *result.StringOf("value[i].id"))
fmt.Println("Name: ", *result.StringOf("value[i].name"))
fmt.Println("Default calendar: ", *result.BoolOf("value[i].isDefaultCalendar"))
fmt.Println("Can edit: ", *result.BoolOf("value[i].canEdit"))
fmt.Println("Owner: ", *result.StringOf("value[i].owner.address"))
i = i + 1
}
pageCount = pageCount + 1
// Quote the member name because @odata.nextLink contains a literal period.
nextType := result.JsonTypeOf("\"@odata.nextLink\"")
if (nextType == -1) || (nextType == 6) {
fmt.Println("Completed pages: ", pageCount)
token.DisposeJsonObject()
http.DisposeHttp()
resp.DisposeHttpResponse()
result.DisposeJsonObject()
nextLink.DisposeStringBuilder()
seenLinks.DisposeStringArray()
return
}
if (nextType != 1) || (result.StringOfEquals("\"@odata.nextLink\"","",true) == true) {
fmt.Println("Invalid continuation link; cannot establish completeness.")
token.DisposeJsonObject()
http.DisposeHttp()
resp.DisposeHttpResponse()
result.DisposeJsonObject()
nextLink.DisposeStringBuilder()
seenLinks.DisposeStringArray()
return
}
url = result.StringOf("\"@odata.nextLink\"")
}
fmt.Println("Stopped at the example's 100-page limit. Save the continuation URL privately to resume.")
token.DisposeJsonObject()
http.DisposeHttp()
resp.DisposeHttpResponse()
result.DisposeJsonObject()
nextLink.DisposeStringBuilder()
seenLinks.DisposeStringArray()