API Endpoints

The foursquare API provides methods for accessing a resource such as a venue, tip, or user, at a canonical URL. For example, information about Clinton Street Baking Co can be found at https://api.foursquare.com/v2/venues/40a55d80f964a52020f31ee3?oauth_token=XXX&v=YYYYMMDD.

Given a resource, you can then drill into a particular aspect, for example https://api.foursquare.com/v2/venues/40a55d80f964a52020f31ee3/tips?oauth_token=XXX&v=YYYYMMDD. Each returned tip will have its own ID, which corresponds to a resource URL, for example https://api.foursquare.com/v2/tips/49f083e770c603bbe81f8eb4?oauth_token=XXX&v=YYYYMMDD.

A given resource also has a series of actions associated with it. For example, by calling https://api.foursquare.com/v2/users/1/request with POST and an oauth_token, you can add this user as a friend.

As covered in our platform docs, our Venues Platform endpoints can be accessed without user authentication and our Merchant Platform endpoints require the end-user to be an authed venue manager. All other endpoints, unless otherwise noted, require user authentication.

GeneralAspectsActions
usersleaderboard
requests
search
badges
checkins
friends
lists
mayorships
photos
tips
todos
venuehistory
approve
deny
setpings
unfriend
update
venuesadd
categories
explore
managed
search
suggestcompletion
timeseries
trending
events
herenow
hours
likes
links
listed
menu
nextvenues
photos
similar
stats
tips
dislike
edit
flag
like
proposeedit
setrole
setsinglelocation
venuegroupsadd
delete
list
timeseriesaddvenue
campaigns
edit
removevenue
update
checkinsadd
recent
likesaddcomment
addpost
deletecomment
like
tipsadd
search
likes
listed
saves
flag
like
unmark
listsaddfollowers
saves
suggestphoto
suggesttip
suggestvenues
additem
deleteitem
follow
moveitem
share
unfollow
update
updateitem
updatesnotificationsmarknotificationsread
photosadd
settingsallset
specialsadd
list
search
configurationflag
retire
campaignsadd
list
timeseriesdelete
end
start
eventscategories
search
add
pagesadd
managing
search
timeseries
venues
follow
pageupdatesadd
list
delete
like
multi