[#1497] Show next available appointment time

API General
,
1

Migrated from Redmine #1497 | Author: John White
Status: Closed | Priority: Low, I can wait | Created: 2025-11-24

I’ve been reading your User API guide and I want to confirm I’ve understood the availability flow correctly.

For each therapist (provider), I’d like to show their next available appointment time on an external site (not for booking directly, just as read-only information).

From the docs, it looks like I should:

  • Call getFirstWorkingDay(unitId) to get the next date when that provider is available.
  • Use that date as both dateFrom and dateTo in getStartTimeMatrix(dateFrom, dateTo, eventId, unitId, count) to retrieve bookable times for a specific service.
  • Take the earliest returned time slot as the “next available appointment” for that provider.

Could you confirm that this is the recommended approach for getting the next available slot per provider via the API?

Also, are there any rate limits or best-practice guidelines for how frequently we can call getFirstWorkingDay / getStartTimeMatrix (e.g. every 10–15 minutes for a couple of dozen providers)?

I’m not going to create bookings via the API – only read availability for display elsewhere.

Thanks!

2

John White wrote:

I have found a solution to this, but can’t see how to delete the ticket.