Description

Returns the lists that this venue appears on.


Request

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


Authentication

User or userless authentication.


Parameters

Name Type Description
VENUE_ID HZXXY3Y Identity of a venue to get lists for.
group edited can be created, edited, followed, friends, other. If no acting user is present, only other is supported.
limit 30 Number of results to return, up to 200.
offset 300 Used to page through results. Must specify a group

Response Fields

Field Description  
id A unique identifier for this list.  
name The user-entered name for this list.  
description The user-entered list description.  
user The user who created this list.  
following Boolean indicating whether the acting user is following this list. Absent if there is no acting user.  
followers count and items of users who follow this list. All items may not be present.  
editable Boolean indicating whether the acting user can edit this list. Absent if there is no acting user.  
collaborative Boolean indicating whether this list is editable by the owner’s friends.  
collaborators count and items of users who have edited this list. All items may not be present.
canonicalUrl The canonical URL for this list, e.g. https://foursquare.com/dens/list/a-brief-history-of-foursquare  
photo A photo for this list.  
venueCount The number of unique venues on the list.  
visitedCount The number of venues on the list visited by the acting user. Absent if there is no acting user.  
listItems count of entries on this list.  

Response

{
  "meta": {
    "code": 200,
    "requestId": "59a0753edb04f50b0d02dbd7"
  },
  "response": {
    "lists": {
      "count": 1277,
      "groups": [
        {
          "type": "others",
          "name": "Lists from other people",
          "count": 1277,
          "items": [
            {
              "id": "4ff21e86e4b0ac2746c17ac1",
              "name": "NYC Bars w/ Free Wi-Fi",
              "description": "",
              "type": "others",
              "user": {
                "id": "2027973",
                "firstName": "The Spark Group",
                "gender": "none",
                "photo": {
                  "prefix": "https://igx.4sqi.net/img/user/",
                  "suffix": "/123456.png"
                }
              },
              "editable": false,
              "public": true,
              "collaborative": false,
              "url": "/thesparkgroup/list/nyc-bars-w-free-wifi",
              "canonicalUrl": "https://foursquare.com/thesparkgroup/list/nyc-bars-w-free-wifi",
              "createdAt": 1341267590,
              "updatedAt": 1474559629,
              "photo": {
                "id": "4e7e76fd46906788c6b9da00",
                "createdAt": 1316910845,
                "prefix": "https://igx.4sqi.net/img/general/",
                "suffix": "/XZYJNQSANIQTTIDP4ZFTEUDXF50Q5234VCKEEMXII1JSV0XS.jpg",
                "width": 537,
                "height": 720,
                "user": {
                  "id": "123456",
                  "firstName": "John",
                  "lastName": "Doe",
                  "gender": "male",
                  "photo": {
                    "prefix": "https://igx.4sqi.net/img/user/",
                    "suffix": "/123456.jpg"
                  }
                },
                "visibility": "public"
              },
              "followers": {
                "count": 108
              },
              "listItems": {
                "count": 147,
                "items": [
                  {
                    "id": "v4cbcafab035d236aebebe64e",
                    "createdAt": 1341320340
                  }
                ]
              }
            },
            {
              "id": "51e85183498e59b10a3f7bea",
              "name": "Summer Parties",
              "description": "Put on your dancing shoes and head to these sizzling spots for summer’s hottest parties.",
              "type": "others",
              "user": {
                "id": "742542",
                "firstName": "Time Out New York",
                "gender": "none",
                "photo": {
                  "prefix": "https://igx.4sqi.net/img/user/",
                  "suffix": "/XXHKCBSQHBORZNSR.jpg"
                },
                "type": "page"
              },
              "editable": false,
              "public": true,
              "collaborative": false,
              "url": "/timeoutnewyork/list/summer-parties",
              "canonicalUrl": "https://foursquare.com/timeoutnewyork/list/summer-parties",
              "createdAt": 1374179715,
              "updatedAt": 1374180690,
              "photo": {
                "id": "51e84fbf8bbdf64c271c797b",
                "createdAt": 1374179263,
                "prefix": "https://igx.4sqi.net/img/general/",
                "suffix": "/742542_FrC-C6NUK0-7sjuLGQcVvyDcQhAhlfjd8Ghw_FxJigE.jpg",
                "width": 555,
                "height": 370,
                "user": {
                  "id": "742542",
                  "firstName": "Time Out New York",
                  "gender": "none",
                  "photo": {
                    "prefix": "https://igx.4sqi.net/img/user/",
                    "suffix": "/XXHKCBSQHBORZNSR.jpg"
                  },
                  "type": "page"
                },
                "visibility": "public"
              },
              "logView": true,
              "followers": {
                "count": 304
              },
              "listItems": {
                "count": 14,
                "items": [
                  {
                    "id": "t51e8543b498e7d7abd657c24",
                    "createdAt": 1374180131,
                    "photo": {
                      "id": "51e854598bbdf64c27214c74",
                      "createdAt": 1374180441,
                      "prefix": "https://igx.4sqi.net/img/general/",
                      "suffix": "/742542_Vj4eR1iQui22nyGV4G-xvfruWkRmr7hcOwXMaPbwVho.jpg",
                      "width": 555,
                      "height": 370,
                      "user": {
                        "id": "742542",
                        "firstName": "Time Out New York",
                        "gender": "none",
                        "photo": {
                          "prefix": "https://igx.4sqi.net/img/user/",
                          "suffix": "/XXHKCBSQHBORZNSR.jpg"
                        },
                        "type": "page"
                      },
                      "visibility": "public"
                    }
                  }
                ]
              }
            }
          ]
        }
      ]
    }
  }
}