На странице https://developer.foursquare.com/overview/responses показан диапазон ошибок http, которые могут быть возвращены API-интерфейс foursquare, а также типы ошибок.
Отсутствует документ, связанный с ответом <-> типы ошибок.
Например, какая ошибка http будет связана с rate_limit_exceeded?403
Отличный вопрос! Мы вернем 403 в этом случае.
Я сделал для нас примечание обновить документацию этой информацией.