Query freebusy information for a set of calendars

POST {{baseUrl}}/calendars/freeBusy

Returns free or busy information for a set of calendars.

Scopes: calendar:write,calendar:write:admin

Rate Limit Label: MEDIUM

Request Body

{"timeMax"=>"<dateTime>", "timeMin"=>"<dateTime>", "timeZone"=>"<string>", "calendarExpansionMax"=>"<integer>", "groupExpansionMax"=>"<integer>", "items"=>[{"id"=>"<email>"}, {"id"=>"<email>"}]}

HEADERS

KeyDatatypeRequiredDescription
Content-Typestring
Acceptstring

RESPONSES

status: OK

{&quot;kind&quot;:&quot;calendar#freeBusy&quot;,&quot;timeMax&quot;:&quot;\u003cdateTime\u003e&quot;,&quot;timeMin&quot;:&quot;\u003cdateTime\u003e&quot;,&quot;calendars&quot;:[{&quot;id&quot;:&quot;\u003cstring\u003e&quot;,&quot;errors&quot;:[{&quot;domain&quot;:&quot;\u003cstring\u003e&quot;,&quot;reason&quot;:&quot;\u003cstring\u003e&quot;},{&quot;domain&quot;:&quot;\u003cstring\u003e&quot;,&quot;reason&quot;:&quot;\u003cstring\u003e&quot;}],&quot;busy&quot;:[{&quot;start&quot;:&quot;\u003cstring\u003e&quot;,&quot;end&quot;:&quot;\u003cstring\u003e&quot;},{&quot;start&quot;:&quot;\u003cstring\u003e&quot;,&quot;end&quot;:&quot;\u003cstring\u003e&quot;}]},{&quot;id&quot;:&quot;\u003cstring\u003e&quot;,&quot;errors&quot;:[{&quot;domain&quot;:&quot;\u003cstring\u003e&quot;,&quot;reason&quot;:&quot;\u003cstring\u003e&quot;},{&quot;domain&quot;:&quot;\u003cstring\u003e&quot;,&quot;reason&quot;:&quot;\u003cstring\u003e&quot;}],&quot;busy&quot;:[{&quot;start&quot;:&quot;\u003cstring\u003e&quot;,&quot;end&quot;:&quot;\u003cstring\u003e&quot;},{&quot;start&quot;:&quot;\u003cstring\u003e&quot;,&quot;end&quot;:&quot;\u003cstring\u003e&quot;}]}],&quot;groups&quot;:[{&quot;id&quot;:&quot;\u003cstring\u003e&quot;,&quot;errors&quot;:{&quot;domain&quot;:&quot;\u003cstring\u003e&quot;,&quot;reason&quot;:&quot;\u003cstring\u003e&quot;},&quot;calendars&quot;:[&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;]},{&quot;id&quot;:&quot;\u003cstring\u003e&quot;,&quot;errors&quot;:{&quot;domain&quot;:&quot;\u003cstring\u003e&quot;,&quot;reason&quot;:&quot;\u003cstring\u003e&quot;},&quot;calendars&quot;:[&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;]}]}