Description

Returns the details about a tip, including which users (especially friends) have marked the tip to-do.


Request

GET https://api.foursquare.com/v2/tips/TIP_ID


Authentication

This endpoint supports userless or user authentication.

Userless calls require a Client ID and Secret in the query string of each request (&client_id=XXXX&client_secret=XXXX).

User calls require a valid OAuth access token in the query string of each request instead of the Client ID and Secret (&oauth_token=XXXX).

For more information about these authentication methods and how to obtain an access token, see the Authentication docs.


Parameters

Name Example Description
TIP_ID 111XXXYY222 required ID of tip to retrieve

Response Fields

Field Description
id A unique identifier for this tip.
text The actual tip.
createdAt Seconds since epoch when their tip was created.
canonicalUrl URL of the tip.
photo If present, details of the photo associated with this tip.
user User that created this tip.
venue Compact venue object this tip is for. For more robust venue information (photos/tips/etc.), please see our venue details endpoint.
lang Language of that the tip is written in.
saves Count of users who have saved this tip.

Response

{
  "meta": {
    "code": 200,
    "requestId": "59cea5346329fb6b767fab2a4f7"
  },
  "response": {
    "tip": {
      "id": "53bc46b7498e355aed38c696",
      "createdAt": 1404847799,
      "text": "Rooftop boozy brunch in Lower East Side. Can't drink all day unless you start in the morning!",
      "type": "user",
      "canonicalUrl": "https://foursquare.com/item/53bc46b7498e355aed38c696",
      "lang": "en",
      "user": {
        "id": "123456",
        "firstName": "Drizzy",
        "type": "user"
      },
      "saves": {
        "count": 1,
        "groups": [],
        "summary": "1 Save"
      },
      "venue": {
        "id": "4cbcafab035d236aebebe64e",
        "name": "Hotel Chantelle",
        "location": {
          "address": "92 Ludlow St",
          "crossStreet": "btwn Delancey & Broome St",
          "lat": 40.71855465714273,
          "lng": -73.98899737888202
        },
        "venuePage": {
          "id": "72046848"
        },
        "categories": [
          {
            "id": "4bf58dd8d48988d116941735",
            "name": "Bar",
            "pluralName": "Bars",
            "shortName": "Bar",
            "icon": {
              "prefix": "https://ss3.4sqi.net/img/categories_v2/nightlife/pub_",
              "suffix": ".png"
            },
            "primary": true
          }
        ]
      }
    }
  }
}

Was this page helpful?
Yes
No
Thank you!