Description

Returns hours for a venue.


Request

GET https://api.foursquare.com/v2/venues/VENUE_ID/hours


Authentication

User or userless authentication.


Parameters

Name Example Description
VENUE_ID 111XXYY222 required ID of venue to retrieve hours for.

Response Fields

Field Description
hours An array of timeframes of open hours.
popular An array of timeframes of popular hours.
days An array of days represented as integers with Monday = 1,…, Sunday = 7 on which these hours apply.
open An array describing the segments of the days in this timeframe in which the venue is open. Each time segment has:
start The time as HHMM (24hr) at which the segment begins.
end The time as HHMM (24hr) at which the segment ends.
includesToday Boolean that indicates if this timeframe includes today.
segments An array of describing the named segments of the days in this timeframe in which the venue is open.

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": []
        }
      ]
    }
  }
}