Opening times

The openingConditions object lets you filter venues based on their open status and availability now, or at specific times. This is crucial for users who need venues that are currently open or will be open when they plan to visit.

Basic structure

  preferences: {
    openingConditions: {
      state: "OPEN",
      atTime: "2025-10-18T19:30:00Z",
    },
  },
 

Properties

Opening states

Only return venues that are currently open.

  preferences: {
    openingConditions: {
      state: "OPEN",
      
state: "OPEN" | "CLOSED" | "ANY"
      atTime: "2025-10-18T19:30:00Z",
    },
  },
 

Time formats

  preferences: {
    openingConditions: {
      state: "OPEN",
      atTime: "19:30", 
    },
  },
 

atTime is optional and flexible, when provided, it can be a date time, or just a time. If you only provide a time, the search will return venues that are open at that time today.

Real-world examples

const searchRequest: SearchRequest = {
  locations: [
    { lat: 51.5072, lon: -0.1276, weight: 50 },
    { lat: 51.5154, lon: -0.1419, weight: 50 },
  ],
  mode: {
    mode: "POINT",
    maxDistance: 750,
  },
  preferences: {
    goodFor: ["Lunch"],
    openingConditions: { state: "OPEN" }, 
  },
 

Best practice

• Use OPEN state for immediate needs: Users often need venues that are open now
• Specify times for planning: Use atTime when users are planning ahead
• Consider user context: Different times suit different use cases
• Handle time zones: Be aware of time zone differences in your application

Time considerations

Peak dining times

Day of week patterns

The returned opening times object

{
  // Other properties
  "regularOpeningHours": [
    {
      "days": ["Mon", "Tue", "Wed", "Thu", "Fri"],
      "timeSlots": [
        {
          "open": "12:00",
          "close": "22:00",
          "isClosed": false,
          "closeNextDay": false
        }
      ]
    },
    {
      "days": ["Sat"],
      "timeSlots": [
        {
          "open": "12:00",
          "close": "17:00",
          "isClosed": false,
          "closeNextDay": false
        }
      ]
    }
  ]
}

Next steps