Introduction to FindTime

In this tutorial, we'll be teaching you how to request the /findtime endpoint to get availability through the API.

Written by Jesper Klingenberg Updated over a week ago

Introduction

Timekit offers two different ways of querying for availability.

Free until booked: Where a resource is available until a booking reserves time in the calendar, usually general business-rules like opening-hours also applies.

Group bookings: Where an available time-slot is defined on beforehand, with a limited number of seats available.

In this article we'll be covering the first type: Free until booked, and how you can configure Timekits FindTime engine to help you create your desired booking experience. Please refer to this tutorial for group bookings if that is more in line with your use-case.

FindTime

Timekit utilizes our FindTime engine to find availability for a resource. It works by requesting the /findtime endpoint with a set of params telling the engine which resource, when, how and for how long.

Let's break it down:

in the request above you'll see that we are have something called resource_ids: This is telling FindTime which of your resources it needs to look at, if you provide more than one ID, the engine will look for mutual availability, which means finding timeslots where both resources are available. If you want a query where any of a list of resources are available, please refer to team availability.

Filters

If you just supply a resource Id and not any filters, FindTime will return all available times 24/7. This is usually not what we're looking for. So we'll apply our filters: to limit availability to only look at Monday between 9 and 13 and Wednesday between 10 and 16 (note we are using 24h clock).

We have a list of filter examples, to give you idea to how you can structure your filters to be in line with your business-rules

Finally you can see we have included "future": "2 days" and "length": "30 minutes" at the bottom of the request. This tells FindTime that it needs to look 2 weeks into the future and look for available time-slots of 30 minutes length.The search-space will default start from the next full hour, but you can modify this with the "start" parameter, like this: "start": "1 day" which would mean that the search-space would start tomorrow.