Deprecating Foursquare API Versions 20120609 and Earlier

[David Hu]

Hello Foursquare developers!

As originally announced a few months ago, we’re continuing with our efforts to version the Foursquare API better. Last month we started requiring a version parameter in all API requests, and today we’re announcing that we’re officially deprecating versions that are now nearly two years old. Starting on June 1, 2014, API requests using versions 20120609 and lower will no longer be supported, and these requests will be rejected. Please note that this covers all requests, including POST requests.

Just like when we deprecated versionless API requests, we will be conducting a sustained API brownout as a last-minute final warning to developers still using old versions. On May 15, 2014, API requests passing in versions 20120609 or lower will be rejected for part of the day. To ensure the smoothest experience for your users, we recommend making any version upgrades prior to this date.

Versioning allows us to make changes to the API while giving developers enough time to update their integrations; however, we never intended to support old versions indefinitely. As always, we recommend regularly updating your versions to take advantage of the latest from Foursquare, such as advanced justifications in Explore and menu item search, which were both added since 20120609.

Please let us know if you have questions about this. This mailing list will remain announcement-only, but as always, for the latest news and updates related to the API follow @foursquareAPI on Twitter and look to our community on StackOverflow for technical support.

Best,

David