# Free/Busy Time Slots

**URL:** <https://forums.nylas.com/t/free-busy-time-slots/1113>\
**Category:** Question and Answers\
**Tags:** calendar-api, google-calendar, events\
**Created:** [February 25, 2026, 9:39pm UTC](https://forums.nylas.com/t/free-busy-time-slots/1113 "2026-02-25T21:39:49Z")\
**Posts on this page:** 4\
**Page:** 1

<div class="post-metadata">

**Author:** ![henry](https://sea1.discourse-cdn.com/flex015/user_avatar/forums.nylas.com/henry/32/392_2.png) [@henry](https://forums.nylas.com/u/henry)\
**Post date:** [February 25, 2026, 9:39pm UTC](https://forums.nylas.com/t/free-busy-time-slots/1113/1 "2026-02-25T21:39:50Z")

</div>

Looking at the Python SDK, specifically with the TimeSlots.status, the value is ‘typically “busy”’.

1. What are the other possible values?
2. Does the free/busy support also fetching events/time slots that are set as “Free”?
  1. If not, is the only way to get these via the Events API?

Thank you!

---

<div class="post-metadata">

**Author:** ![Samuel.R](https://avatars.discourse-cdn.com/v4/letter/s/6bbea6/32.png) [@Samuel.R](https://forums.nylas.com/u/Samuel.R)\
**Post date:** [February 26, 2026, 1:14pm UTC](https://forums.nylas.com/t/free-busy-time-slots/1113/2 "2026-02-26T13:14:28Z")

</div>

Hello,

The Free/Busy endpoint is designed to return only the **busy** time ranges. Free time is represented implicitly, any time range _not_ covered by a returned time slot is free.

Each event has a **`busy`** boolean field ( **`true`** = busy, **`false`** = free). You can fetch all events via **`GET /v3/grants/{id}/events`** and check the **`busy`** field to find events where the user’s status is set to “Free” ( **`busy: false`** ). There’s no way to filter by **`busy`** status in the query parameters, so you’d need to fetch events for the time range and filter client-side.

Many thanks,  
Samuel R.  
Support Engineer, Nylas

---

<div class="post-metadata">

**Author:** ![henry](https://sea1.discourse-cdn.com/flex015/user_avatar/forums.nylas.com/henry/32/392_2.png) [@henry](https://forums.nylas.com/u/henry)\
**Post date:** [February 26, 2026, 8:46pm UTC](https://forums.nylas.com/t/free-busy-time-slots/1113/3 "2026-02-26T20:46:22Z")

</div>

Thank you for confirming!

---

<div class="post-metadata">

**Author:** ![Samuel.R](https://avatars.discourse-cdn.com/v4/letter/s/6bbea6/32.png) [@Samuel.R](https://forums.nylas.com/u/Samuel.R)\
**Post date:** [February 27, 2026, 11:57am UTC](https://forums.nylas.com/t/free-busy-time-slots/1113/4 "2026-02-27T11:57:25Z")

</div>

Closed on February 27, 2026, 11:57am UTC