Get Venue Hours

Public Beta Feature

This documentation covers a feature currently in Public Beta. Access is available to anyone interested in building personalized experiences for their end-users.

This feature is subject to the Personalization API (Self-Service) Public Beta End user License Agreement.

Parameters

Parameter Type Required Description
venue_id string required The venue you want photos for; e.g., Foursquare HQ's venue_id = 5a187743ccad6b307315e6fe
v string required The API version date as documented here; e.g. 20231010
hourFormat int32 12 or 24
accept string enum Defaults to application/json

Example Request

curl --request GET \
     --url https://api.foursquare.com/v2/venues/venue_id/hours \
     --header 'accept: application/json'

Example Response

{
  "meta": {
    "code": 200,
    "requestId": "59a04e6fdd579714214cddc0"
  },
  "response": {
    "hours": {
      "timeframes": [
        {
          "days": [
            1,
            2,
            3,
            4,
            5
          ],
          "includesToday": true,
          "open": [
            {
              "start": "1600",
              "end": "+0100"
            }
          ],
          "segments": []
        },
        {
          "days": [
            6,
            7
          ],
          "open": [
            {
              "start": "1400",
              "end": "+0000"
            }
          ],
          "segments": []
        }
      ]
    },
    "popular": {
      "timeframes": [
        {
          "days": [
            5
          ],
          "includesToday": true,
          "open": [
            {
              "start": "1700",
              "end": "+0000"
            }
          ],
          "segments": []
        },
        {
          "days": [
            6
          ],
          "open": [
            {
              "start": "1600",
              "end": "+0000"
            }
          ],
          "segments": []
        },
        {
          "days": [
            7
          ],
          "open": [
            {
              "start": "1500",
              "end": "2300"
            }
          ],
          "segments": []
        },
        {
          "days": [
            1,
            2,
            3
          ],
          "open": [
            {
              "start": "1800",
              "end": "2300"
            }
          ],
          "segments": []
        },
        {
          "days": [
            4
          ],
          "open": [
            {
              "start": "1800",
              "end": "+0000"
            }
          ],
          "segments": []
        }
      ]
    }
  }
}