---
title: "Find open times"
method: GET
path: "/api/v1/public/{handle}/{slug}/slots"
tags: ["public"]
---

# Find open times

`GET /api/v1/public/{handle}/{slug}/slots`

## Request

- Base URL: `https://meettempi.com`
- URL: `https://meettempi.com/api/v1/public/{handle}/{slug}/slots`
- Auth: none required

Returns the start times that can be booked, with the hosts' calendars, buffers and limits already applied. Pass the invitee's `timezone` and either `date` (YYYY-MM-DD in `timezone`) or `from` and `to` (ISO, at most 62 days apart). With neither, it covers the next 7 days. `days` groups the slots by date in `timezone`, and `times` gives each slot as a local time to show people. People can book up to `bookableUntil`. When the range has no open times, `next` is the next one. When `timezone` was an abbreviation that names more than one zone (CST, IST, BST), `timezoneNote` says which one was used: check it with the person. For new times for an existing booking, also pass its `bookingId` and `token`. Next: call create_booking (or reschedule_booking_as_invitee) with one of the `slots` values as `start`.

## Path parameters

- `handle` string, required: a handle, the first part of a booking link ("acme" in meettempi.com/acme/demo), or the whole link
- `slug` string, required: an event type slug from get_public_profile ("demo" in meettempi.com/acme/demo), or the whole link

## Query parameters

- `timezone` string, required: the invitee's time zone, an IANA id like America/New_York or an abbreviation like EST: days, dates and times are in it
- `date` string, date: one day to look at, as YYYY-MM-DD in `timezone`
- `from` string, date-time: start of the range, ISO with an offset
- `to` string, date-time: end of the range, ISO with an offset
- `bookingId` string: the booking id from create_booking, or its manageUrl
- `token` string: the token from create_booking, or the manageUrl

## Response `200`

Success

## Other responses

- `default`: Error

---

[API](https://skmtc.dev/meettempi/apis/tempi-api.md) · [All operations](https://skmtc.dev/meettempi/apis/tempi-api/llms.txt) · [OpenAPI document](https://skmtc.dev/meettempi/apis/tempi-api/revisions/36787210a2ce?raw)