GET - Get user booking detail

Purpose

This API retrieves a user's booking detail. The user can use this API to fetch details of all the bookings done by him/ her.

Request URL

https://calendar.zoho.com/api/v1/bookings/mybookings

OAuth Scope

scope=ZohoCalendar.bookings.ALL

or

scope=ZohoCalendar.bookings.READ

 

ALL - Access to all bookings

READ - Gets details of your bookings

Request Parameters

  • start_datestring, mandatory
    • The start date is the date from when you want to fetch the details of a booking done by a user. The supported date format is MM/DD/YYYY.
  • end_datestring, mandatory
    • The end date is the date upto when you want to fetch the details of a booking done by a user. The supported date format is MM/DD/YYYY.
  • timezonestring, optional
    • The timezone in which the booking has been made.

Sample Request

Copiedhttps://calendar.zoho.com/api/v1/bookings/mybookings?start_date=08/06/2020&end_date=11/06/2020

Sample Response

Copied{
"resources":"[{\"building_id\":\"1587118394647000044\",\"category_name\":\"Training Room\",\"resource_type\":0,\"is_hidden\":false,\"description\":\"\",\"res_email_id\":\"d7bbdad7e5524201adc0272e55a04320@m43.com\",\"resource_approval\":false,\"auto_gen_name\":\"d7bbdad7e5524201adc0272e55a04320\",\"capacity\":56,\"is_available\":true,\"has_image\":false,\"branch_id\":\"1587118394614000006\",\"resource_id\":\"1587118423362000034\",\"floor_id\":\"1587118394648000046\",\"resource_name\":\"SCREEN 2\",\"category\":2},{\"building_id\":\"1594972463962000002\",\"category_name\":\"Conference Room\",\"resource_type\":0,\"is_hidden\":false,\"res_email_id\":\"956266fbc5154337b7cbc6fc0e2ba70c@m43.com\",\"resource_approval\":false,\"auto_gen_name\":\"956266fbc5154337b7cbc6fc0e2ba70c\",\"capacity\":205,\"is_available\":true,\"features\":[{\"feature_id\":\"1587118410674000014\",\"feature_value\":\"2\"}],\"has_image\":false,\"branch_id\":\"1594972463960000001\",\"resource_id\":\"1596541196591000001\",\"floor_id\":\"1594972463966000003\",\"resource_name\":\"M205 room\",\"category\":1}]","bookings":"{\"20200807\":[{\"end_date\":\"20200807\",\"isprivate\":false,\"role\":\"organizer\",\"is_member\":true,\"timezone\":\"Asia/Calcutta\",\"end_time\":\"0315\",\"title\":\"Att book update\",\"booking_id\":\"1596693672887000001\",\"isbreak\":true,\"start_time\":\"0230\",\"bookedby_email\":\"cal9@m43.com\",\"booked_by\":\"61298224\",\"is_own_booking\":true,\"all_day\":false,\"resource_id\":\"1587118423362000034\",\"start_date\":\"20200807\"}],\"20200806\":[{\"end_date\":\"20200806\",\"isprivate\":false,\"role\":\"organizer\",\"is_member\":true,\"timezone\":\"Asia/Calcutta\",\"end_time\":\"0215\",\"title\":\"repeat booking only\",\"booking_id\":\"1596549958803000001\",\"isbreak\":true,\"start_time\":\"0145\",\"bookedby_email\":\"cal9@m43.com\",\"booked_by\":\"61298224\",\"is_own_booking\":true,\"all_day\":false,\"resource_id\":\"1596541196591000001\",\"start_date\":\"20200806\"},{\"end_date\":\"20200806\",\"isprivate\":false,\"role\":\"organizer\",\"is_member\":true,\"timezone\":\"Asia/Calcutta\",\"end_time\":\"1045\",\"title\":\"rep book only\",\"booking_id\":\"1596550889826000001\",\"isbreak\":true,\"start_time\":\"1015\",\"bookedby_email\":\"cal9@m43.com\",\"booked_by\":\"61298224\",\"is_own_booking\":true,\"all_day\":false,\"resource_id\":\"1596541196591000001\",\"start_date\":\"20200806\"}],\"20200808\":[{\"end_date\":\"20200808\",\"isprivate\":false,\"role\":\"organizer\",\"is_member\":true,\"timezone\":\"Asia/Calcutta\",\"end_time\":\"0515\",\"title\":\"rep book only\",\"booking_id\":\"1596550703800000001\",\"isbreak\":true,\"start_time\":\"0445\",\"bookedby_email\":\"cal9@m43.com\",\"booked_by\":\"61298224\",\"is_own_booking\":true,\"all_day\":false,\"resource_id\":\"1596541196591000001\",\"start_date\":\"20200808\"}]}"
}