tiempoAPI reference
Use cases

Chains and multi-location businesses

A business with several sites is still one account, with a location per site. Staff belong to the business, not a shop, so someone who works Mondays in Soho and Tuesdays in Shoreditch is one resource with one diary, and can never be booked in both places at once.

Independent businesses that happen to share an owner (franchises, say) are usually separate accounts, so their data, staff and bookings stay apart. That’s your product’s call.

Who works where

Each interval of a schedule can name a location; without one it falls back to the resource’s default_location. Times are read in that location’s timezone, so a chain across London and Madrid writes everyone’s hours in local time.

Rooms and chairs that never move just get a default_location and a plain schedule.

Closing one site

A block on a location closes that site for everyone scheduled there, for a refit or a bank holiday that only one city observes. Staff who are at another site that day are untouched. A block on the account closes every site at once.

Bookings caught by a closure are flagged conflicted with a booking.conflicted webhook, so each shop can rebook its customers.

Reporting across sites

Every booking segment records its location, and every change is an event your webhook receives, so your app can keep per-shop reports in its own database. To list a site’s day, list the account’s bookings for the date and group them by segment location.

Start with the salons guide for services and staff, or the locations reference.