Description

A User’s Lists.


Request

GET https://api.foursquare.com/v2/users/USER_ID/lists


Authentication

User authentication.


Parameters

Name Example Description
USER_ID HZXXY3Y Identity of the user to get lists for. Pass self to get lists of the acting user.
group edited can be created (lists created by this user), edited (other people’s lists this user has edited), followed (lists this user follows), friends (lists from this user’s friends), and suggested (lists relevant to the user’s current location).
ll 40.7,-74 Location of the user, required in order to receive the suggested group.
limit 100 Number of results to return, up to 200.
offset 100 The number of results to skip. Used to page through results.

Response Fields

Field Description Presence
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 and items of items on this list.