GET - Get calendar list
Purpose
This API is used to get the list of all calendars or list of calendars based on a specific category/entity of a given user.
Request URL
https://calendar.zoho.com/api/v1/calendars
OAuth Scope
scope=ZohoCalendar.calendar.ALL
(or)
scope=ZohoCalendar.calendar.READ
ALL - Full access to calendars
READ - Gets list of calendars
Parameters
- Categorystring
Get calendars based on a particular category. Calendar category values are:
- own
- group
- app
- others
- all
Note: If the category is not mentioned, you will get all your own calendars.
- showhiddencalboolean
Choose whether the hidden calendars need to be shown.
- True - to show the hidden calendar
- False - to skip the hidden calendar (default)
Sample Request
Copiedhttp://calendar.zoho.com/api/v1/calendars
Sample Input
Copiedhttps://calendar.zoho.com/api/v1/calendars?category=own&showhiddencal=true
Sample Response
Copied{
"calendars": [
{
"reminders": [
{
"minutes": "-15",
"action": "email"
}
],
"color": "#8cbf40",
"timezone": "Asia/Calcutta",
"textcolor": "#FFFFFF",
"description": "",
"privilege": "owner",
"type": 0,
"calemptiedtime": "20230316T052733Z",
"uid": "1683be4ab6c74d2ab02e6450a0b34d4a",
"canSendMail": true,
"modifiedtime": 1663320706496,
"alarm": [
{
"action": "email",
"trigger": "-900000"
}
],
"isdefault": true,
"calendar_modifiedtime": 1663320706496,
"id": "310935000000002003",
"order": 0,
"lastmodifiedtime": "20230316T092945Z",
"owner": "70421274",
"visibility": true,
"include_infreebusy": true,
"createdtime": 1663320706496,
"calendar_createdtime": 1663320706496,
"name": "user",
"ctag": 1678958985948,
"category": "own",
"status": true,
"caltype": "own"
},
{
"color": "#EB0000",
"timezone": "Asia/Calcutta",
"textcolor": "#FFFFFF",
"description": "",
"privilege": "owner",
"type": 0,
"uid": "8941441f4e3140e8b48bdf9bb3a1f7af",
"canSendMail": true,
"modifiedtime": 1674117865556,
"isdefault": false,
"calendar_modifiedtime": 1674117865556,
"id": "310935000000052005",
"order": 1,
"lastmodifiedtime": "20230306T092323Z",
"owner": "70421274",
"visibility": true,
"include_infreebusy": false,
"createdtime": 1671083856866,
"calendar_createdtime": 1671083856866,
"name": "new calendar",
"ctag": 1678094603679,
"category": "own",
"status": true,
"caltype": "own"
},
{
"color": "#8cbf40",
"timezone": "Asia/Calcutta",
"textcolor": "#FFFFFF",
"description": "",
"privilege": "owner",
"type": 0,
"uid": "66e82e905c81428aa843006f4385f592",
"canSendMail": true,
"modifiedtime": 1674116995358,
"isdefault": false,
"calendar_modifiedtime": 1674116995358,
"id": "310935000000078001",
"order": 2,
"lastmodifiedtime": "20230120T052451Z",
"owner": "70423274",
"visibility": true,
"include_infreebusy": false,
"createdtime": 1674116962474,
"calendar_createdtime": 1674116962474,
"name": "new 2 edited",
"ctag": 1674192291367,
"category": "own",
"status": true,
"caltype": "own"
},
{
"color": "#A514D8",
"timezone": "Asia/Calcutta",
"textcolor": "#FFFFFF",
"description": "",
"privilege": "owner",
"type": 0,
"uid": "d7c153468f5c4ba19b6926796fdef9e4",
"canSendMail": true,
"modifiedtime": 1674473723258,
"isdefault": false,
"calendar_modifiedtime": 1674473723258,
"id": "310935000000082005",
"order": 3,
"lastmodifiedtime": "20230214T055837Z",
"owner": "70423274",
"visibility": true,
"include_infreebusy": false,
"createdtime": 1674473668980,
"calendar_createdtime": 1674473668980,
"name": "Test Subscribe private",
"ctag": 1676354317170,
"category": "own",
"status": true,
"caltype": "own"
},
{
"color": "#8cbf40",
"timezone": "Asia/Calcutta",
"textcolor": "#FFFFFF",
"description": "",
"privilege": "owner",
"type": 0,
"uid": "46d3aef248384773b1649360152a44eb",
"canSendMail": true,
"modifiedtime": 1678946331370,
"isdefault": false,
"calendar_modifiedtime": 1678946331370,
"id": "310935000000136011",
"order": 5,
"lastmodifiedtime": "20230214T055915Z",
"owner": "70421274",
"visibility": false,
"include_infreebusy": false,
"createdtime": 1678946331370,
"calendar_createdtime": 1678946331370,
"name": "Hidden calendar",
"ctag": 1676354355042,
"category": "own",
"status": true,
"caltype": "own"
}
]
}