Developer docs

Venue

The six GETs that describe a venue completely — profile, business info, opening hours, menus, resources and floor plan, one page each.

Six reads describe a venue completely. They are cheap, cacheable on your side, and change only when the operator edits something in the console. All of them take the venue's slug in the path, need a key (Keys and headers), and answer 404 with a problem body when no venue has that slug. Each read has its own page below, with its response fields, a JSON example and request samples in three languages.

Endpoints

Page Endpoint
Profile GET /api/venues/{venueSlug}
Business info GET /api/venues/{venueSlug}/business-info
Opening hours GET /api/venues/{venueSlug}/opening-hours
Menus GET /api/venues/{venueSlug}/menus
Resources GET /api/venues/{venueSlug}/resources
Floor plan GET /api/venues/{venueSlug}/floor-plan

Caching

None of these responses carries a cache header, because the operator can change them at any moment. A sensible integration caches them for minutes, not days, and refetches on a 404 or a schema it does not recognise. The widget itself reads the venue profile and floor plan once per page load and never caches across loads.

Next steps

  • Availability — turn a resource type and a date into bookable slots.
  • .NET SDK — the same six reads as typed methods.