Get Free/Busy Schedule

POST {{baseUrl}}/v3/grants/:grant_id/calendars/free-busy

Get the free/busy schedule for a list of email addresses. The Grant ID included in the request must have access to view the provided emails' free/busy data (typically, this is configured by the provider). All email addresses must use the same provider (Google, Microsoft, etc).

Request Body

{"start_time"=>"<integer>", "end_time"=>"<integer>", "emails"=>["<string>", "<string>"]}

HEADERS

KeyDatatypeRequiredDescription
Content-Typestring
Acceptstring

RESPONSES

status: OK

{&quot;request_id&quot;:&quot;\u003cstring\u003e&quot;,&quot;data&quot;:[{&quot;email&quot;:&quot;\u003cstring\u003e&quot;,&quot;time_slots&quot;:[{&quot;start_time&quot;:&quot;\u003cinteger\u003e&quot;,&quot;end_time&quot;:&quot;\u003cinteger\u003e&quot;,&quot;status&quot;:&quot;\u003cstring\u003e&quot;,&quot;object&quot;:&quot;\u003cstring\u003e&quot;},{&quot;start_time&quot;:&quot;\u003cinteger\u003e&quot;,&quot;end_time&quot;:&quot;\u003cinteger\u003e&quot;,&quot;status&quot;:&quot;\u003cstring\u003e&quot;,&quot;object&quot;:&quot;\u003cstring\u003e&quot;}],&quot;error&quot;:&quot;\u003cstring\u003e&quot;,&quot;object&quot;:&quot;\u003cstring\u003e&quot;},{&quot;email&quot;:&quot;\u003cstring\u003e&quot;,&quot;time_slots&quot;:[{&quot;start_time&quot;:&quot;\u003cinteger\u003e&quot;,&quot;end_time&quot;:&quot;\u003cinteger\u003e&quot;,&quot;status&quot;:&quot;\u003cstring\u003e&quot;,&quot;object&quot;:&quot;\u003cstring\u003e&quot;},{&quot;start_time&quot;:&quot;\u003cinteger\u003e&quot;,&quot;end_time&quot;:&quot;\u003cinteger\u003e&quot;,&quot;status&quot;:&quot;\u003cstring\u003e&quot;,&quot;object&quot;:&quot;\u003cstring\u003e&quot;}],&quot;error&quot;:&quot;\u003cstring\u003e&quot;,&quot;object&quot;:&quot;\u003cstring\u003e&quot;}]}