Description

Returns a list of recent checkins from friends.


Request

GET https://api.foursquare.com/v2/checkins/recent


Authentication

User authentication.


Parameters

Name Type Description
ll 44.3,37.2 Latitude and longitude of the user’s location, so response can include distance.
limit 20 Number of results to return, up to 100.
afterTimestamp 123456 Seconds after which to look for checkins, e.g. for looking for new checkins since the last fetch. If more than limit results are new since then, this is ignored. Checkins created prior to this timestamp will still be returned if they have new comments or photos, making it easier to poll for all new activity.

Response Fields

Field Description
id A unique identifier for this checkin.
type One of checkin, shout, or venueless.
timeZoneOffset The offset in minutes between when this check-in occurred and the same time in UTC. For example, a check-in that happened at -0500 UTC will have a timeZoneOffset of -300.
createdAt Seconds since epoch when this checkin was created.
private If present, it indicates the checkin was marked as private and not sent to friends. It is only being returned because the owner of the checkin is viewing this data.
shout Message from check-in, if present and visible to the acting user.
user User who made this check-in.
venue Venue for this check-in.
location If the type of this checkin is shout or venueless, this field may be present and may contains a lat, lng pair and/or a name, providing unstructured information about the user’s current location.
source If present, the name and url for the application that created this checkin.
event If the user checked into an event, this field will be present, containing the id and name of the event
photos count and items for photos on this checkin. All items may not be present.
comments count and items for comments on this checkin. All items may not be present.
likes The count of users who have liked this checkin, and groups containing any friends and others who have liked it. The groups included are subject to change.
overlaps count and items of checkins from friends checked into the same venue around the same time.
score total and scores for this checkin