RentalTideRentalTideRentalTideDocs
Dashboard›

Location hours API

Show a RentalTide location's opening hours on your own website. One public request returns open now, this season's weekly hours, closures and holiday hours, and the next season.

Show your opening hours on your own website from the hours you already keep in RentalTide, so the two never disagree. One request, no key, and it is safe to call from a browser.

HTTP
GET https://v3.api.rentaltide.com/public/hours/v1?locationId=loc_31503516
Not a developer?

You do not need the API to show your hours. In RentalTide go to Marketing > SEO & Embed Tools > Embed on Site, pick the location, and copy the Opening hours snippet into your website. See The hours embed below.

Where the hours come from

RentalTide has no separate "hours" setting to keep in sync. The hours are the ones your booking page sells by:

  • Each rental listing's weekly hours, per pricing season. Set them on the listing's Hours & closures tab. Location Settings > Hours & Availability > Days open shows the same answer.
  • Your Holidays and calendar closures, and each season's own dated exceptions (a holiday that closes early, a closed day).

A location with several listings is open when any of them is, from the earliest opening to the latest closing. Ask for one listing's hours with listing when your listings keep different hours.

A location with no rental seasons at all (tours only, for example) falls back to the location's own Opening time and Closing time under Hours & Availability. The response says which one it used in source.

Tours are not included: a tour's days are its departures, which the booking page lists.

Request

GET https://v3.api.rentaltide.com/public/hours/v1

ParameterRequiredValue
locationIdyesThe location's id. It is in SEO & Embed Tools (the snippets carry it) and in the locationId of your booking page link.
listingnoOne listing's inventoryId (from listings in the response) to get that listing's hours instead of the location's.

No key and no sign-in. The response is the same for everyone and is sent with Cache-Control: public, max-age=300, so a browser or CDN may keep it for five minutes. Access-Control-Allow-Origin: * lets a web page call it directly.

Response

Paddle Sports Center on Monday 16 November 2026. It closes on Mondays in Winter, so today is closed and it opens again on Tuesday at 11:00.

JSON

(The Thanksgiving closure is an example of what a Holiday looks like; add yours under Holidays.)

Fields

FieldMeaning
locationName, IANA time zone, address, phone and booking page link.
listingThe listing you asked for with listing, else null.
listingsThe location's public rental listings, for listing.
sourcelistings (the listings' seasons), location (the location's own Opening and Closing time) or none (no hours set; everything below is empty).
temporarilyClosedThe location is marked Temporarily closed. openNow is then false and nextOpen is null; temporarilyClosedMessage is the note you show customers.
todayToday in the location's time zone, with any closure or holiday hours applied.
openNowOpen at generatedAt. null when today's hours are not known.
closesAtWhen open now: today's closing time.
nextOpenWhen not open now: the next opening, up to about a year ahead.
seasonsThe season in effect today (current: true), then the following ones up to the next season with hours. Each has its weekly days, Monday first.
seasons[].nameThe season's name in RentalTide. null when listings in the same stretch use different season names.
seasons[].startDate, endDateLocal dates the hours apply from and to. null when they began more than a year ago or run on more than two years.
seasons[].offSeasonNothing is open in this stretch: every day is closed.
exceptionsThe next 60 days whose hours differ from their weekday's regular hours: holidays, closures, early closes. note is the label you gave it.

Times are local to the location: open and close are HH:mm (a close of 24:00 means midnight), and closesAt and nextOpen are ISO 8601 with the location's UTC offset on that date, so daylight saving is already applied.

openNow is worked out when the response is made, and a cached response can be up to five minutes old. For an exact answer, compare the current time in location.timezone with today.open and today.close; the embed does this.

Errors

StatusWhen
400No locationId, or a value that cannot be an id.
404No such location (or it is not public), or no such public listing.
429Too many requests from one address. Cache the response and retry later.

The hours embed

For a website without a developer: paste this where the hours should appear. It draws the hours into your page itself (no frame), so it uses your website's fonts, colours and table styles.

HTML

It shows whether you are open now, this season's hours with today in bold, closures and holiday hours in the next 60 days, and next season's hours. Marketing > SEO & Embed Tools > Embed on Site > Opening hours gives you the snippet with your location already filled in.

Options go on the div:

AttributeEffect
data-listing="<id>"One listing's hours instead of the location's.
data-clock="24h"24-hour times (the default is 12-hour, like 5:00 PM).
data-next-season="false"Leave out the next season's hours.
data-closures="false"Leave out closures and holiday hours.

Every element has an rt-hours__* class (rt-hours__status, rt-hours__table, rt-hours__row--today, rt-hours__exceptions, ...) for your own CSS. Several hours boxes on one page share one request. Anything you put inside the div stays there if the hours cannot be loaded, so a plain "Our hours" link makes a good fallback.

Was this page helpful?
Need help? Contact Support.See what’s new. Check out changelog.Questions? Book a video chat.
Ask AI
Responses are generated using AI and may contain mistakes.
Ask questions about RentalTide and get help with your integration.