Read your free appointment times over the API

Released 19 August 2026

If you build on our API, you can now ask your workspace what it can be booked for and when it's free — the same times a customer would be offered on your booking page.

What's new

• List what you take bookings for — a new endpoint returns every service you offer, how long each runs, how much notice it needs, how far ahead its diary is open, and who can perform it. That's where the ids for the availability call come from, so nothing has to be copied out of the console by hand.
• Ask when it's free — a second endpoint returns the open times for one service. Free means genuinely free: inside someone's working hours, and clear of every confirmed appointment, every booking someone is midway through making, the turnaround time you set around a service, and — if you connected it — everything already on your Google Calendar.
• The same answer your booking page gives — both run the engine your booking page and your console slot picker already use, so an integration can never offer a time a customer couldn't have had.
• Dates the way you'd write them — ask for a window as plain dates (2026-08-20), and it means that day where your workspace is, not in some other time zone. Times come back both as a timestamp and as your own local clock time, so "Thursday 9:00 am" is right there without any conversion.
• Every free time says who could take it — ask for anyone, and each time lists the people available then; ask about one person, and you get only their diary.
• A quiet day and a problem look different — nothing free is simply an empty answer, while something you need to fix — appointments not switched on yet, or nobody assigned to a service — says so plainly.

Tick Read bookable services & free times on an API key or client under Developers to switch it on. Taking the booking itself still happens on your booking page, in the console, or over WhatsApp.