---
title: "POST /freeBusy"
method: POST
path: "/freeBusy"
tags: ["freebusy"]
---

# POST /freeBusy

`POST /freeBusy`

Returns free/busy information for a set of calendars.

## Request body

- FreeBusyRequest
  - `groupExpansionMax` integer — Maximal number of calendar identifiers to be provided for a single group. Optional. An error is returned for a group with more members than this value. Maximum value is 100.
  - `timeMax` string, date-time — The end of the interval for the query formatted as per RFC3339.
  - `timeZone` string — Time zone used in the response. Optional. The default is UTC.
  - `items` FreeBusyRequestItem[] — List of calendars and/or groups to query.
    - `id` string — The identifier of a calendar or a group.
  - `timeMin` string, date-time — The start of the interval for the query formatted as per RFC3339.
  - `calendarExpansionMax` integer — Maximal number of calendars for which FreeBusy information is to be provided. Optional. Maximum value is 50.

## Response `200`

Successful response

---

[API](https://skmtc.net/google/apis/calendar.md) · [All operations](https://skmtc.net/google/apis/calendar/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/google/calendar/revisions/8a9c54b56c55/schema)