Description

Allows you to check in to a place.


Request

POST https://api.foursquare.com/v2/checkins/add


Authentication

User authentication.


Parameters

Name Example Description
venueId 111XXYY222 required The venue where the user is checking in. Find venue IDs by searching or from historical APIs.
eventId What a view! A message about your check-in. The maximum length of this field is 140 characters.
shout 111XXYY222 The event the user is checking in to.
mentions 5,10,12a34b5e6 Mentions in your check-in. This parameter is a semicolon-delimited list of mentions. A single mention is of the form start,end,userid, where start is the index of the first character in the shout representing the mention, end is the index of the first character in the shout after the mention, and userid is the userid of the user being mentioned. If userid is prefixed with fbu-, this indicates a Facebook userid that is being mentioned. Character indices in shouts are 0-based.
broadcast public,twitter Who to broadcast this check-in to. Accepts a comma-delimited list of values (private, public, facebook, twitter, or followers). If no valid value is found, the default is public.
ll 44.3,37.2 Latitude and longitude of the user’s location. Only specify this field if you have a GPS or other device reported location for the user at the time of check-in.
llAcc 1 Accuracy of the user’s latitude and longitude, in meters.
alt 0 Altitude of the user’s location, in meters.
altAcc 1 Vertical accuracy of the user’s location, in meters.