Zimbra REST API Reference:Get Calendar

<< Back to Zimbra REST API Reference

REST API Method: Get Calendar

Gets the appointments from the calendar. The default folder is "calendar" but user-defined folders are also supported.

URL

http://localhost:7070/home/john.doe/calendar?{params}

HTTP Method

GET

Formats

ics,json,xml,rss,atom,html (Go to Response Formats)

Requires Authentication

true (Go to Authentication)

Parameters

• fmt. Optional. The response format. Defaults to ics
• start. Optional. The start time range (milliseconds | yyyy/dd/mm | mm/dd/yyy | #relative dates ).
• end. Optional. The end time range (milliseconds | yyyy/dd/mm | mm/dd/yyy | #relative dates ).
• query. Optional. A query string.

Relative Dates

Relative dates are either in the future (p/+/{not-specified}) or the past (m/-), along with a numeric value, followed by the units.

For units, everything after the first character is ignored (except for the "mi" case):

   * m(onths)
   * mi(nutes)
   * d(ays)
   * w(eeks)
   * h(ours)
   * y(ears) 

Examples 1day 1 day from now +2days 2 days from now p1day 1 day from now -2days 2 days ago +60mi 60 minutes from now +1week 1 week from now +6mon 6 months from now 1year 1 year from now

HTML Format Parameters

• view. Optional. Designates the display when using the html format. Options include: day, week, workWeek, month.
• date. Optional. Designates the date to display when using the html format. Format is date=[yyyymmdd]. For example, 2/15/2010 is date=20100215.
• notoolbar. Optional. Specifies to not include the toolbar (notoolbar=1)
• color. Optional. The color of the appointment text. Options include:

  Value	Color
  0	defaultColor
  1	blue
  2	cyan
  3	green
  4	purple
  5	red
  6	yellow
  7	pink
  8	gray
  9	orange

Usage Examples

Download the calendar as an iCalendar (ICS) file:

http://localhost:7070/home/john.doe/calendar

http://localhost:7070/home/john.doe/calendar?fmt=ics

Retrieve the calendar in XML format:

http://localhost:7070/home/john.doe/calendar?fmt=xml

Retrieve the calendar from the user-defined folder "MyHolidays" in JSON format:

http://localhost:7070/home/john.doe/myholidays?fmt=json

Retrieve the calendar in JSON format:

http://localhost:7070/home/john.doe/calendar?fmt=json

Retrieve the calendar HTML "month" view:

http://localhost:7070/home/john.doe/calendar.html

http://localhost:7070/home/john.doe/calendar?fmt=html

Retrieve the calendar HTML "workWeek" view:

http://localhost:7070/home/john.doe/calendar?fmt=html&view=workWeek

Retrieve the calendar HTML "day" view on January 23, 2009 (01/23/2009):

http://localhost:7070/home/john.doe/calendar?fmt=html&view=day&date=20090123