Description

Returns a history of checkins for the authenticated user.


Request

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


Authentication

User authentication.


Parameters

Name Example Description
USER_ID self For now, only self is supported
limit 100 Number of results to return, up to 250.
offset 100 The number of results to skip. Used to page through results.
sort newestfirst How to sort the returned checkins. Can be newestfirst or oldestfirst.
afterTimestamp 1279044824 Retrieve the first results to follow these seconds since epoch. This should be useful for paging forward in time, or when polling for changes. To avoid missing results when polling, we recommend subtracting several seconds from the last poll time and then de-duplicating.
beforeTimestamp 1279044824 Retrieve the first results prior to these seconds since epoch. Useful for paging backward in time.

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 If the user is not clear from context, then a compact user is present.
venue If the venue is not clear from context, and this checkin was at a venue, then a compact venue is present.
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