Lists

https://api.foursquare.com/v2/users/USER_ID/lists
A User's Lists.
HTTP MethodGET
Requires Acting UserYes (learn more)
Parameters
All parameters are optional, unless otherwise indicated.
USER_IDHZXXY3YIdentity of the user to get lists for. Pass self to get lists of the acting user.
groupeditedcan 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).
ll40.7,-74Location of the user, required in order to receive the suggested group.
Response fields
listsIf group is specified, contains a count and items of lists.
If no group is specified, it contains a groups array containing elements, each with type, name, an optional count and optional items. The type field can be passed in as a group to get more elements. If present, count represents the total number of elements. If not specified, there are a potentially unbounded number of elements. items contains a sample of the items.

Try it out