Flag Tip

Public Beta Feature

This documentation covers a feature currently in Public Beta. Access is available to anyone interested in building personalized experiences for their end-users.

This feature is subject to the Personalization API (Self-Service) Public Beta End user License Agreement.

Parameters

Example Response Structure

{
  "meta": {
    "code": 200,
    "requestId": "6585aea1634f0a74ffe56e38"
  },
  "notifications": [
    {
      "type": "notificationTray",
      "item": {
        "unreadCount": 0
      }
    }
  ],
  "response": {
    "id": "4f0de7267bebfc146005dcc0",
    "name": "Mattlantis 🐳",
    "venueChains": [],
    "attributes": {
      "groups": []
    },
    "flags": {
      "count": 1,
      "items": [
        {
          "id": "6585aea129b1872b7ff5ed82",
          "type": "tip",
          "comments": [],
          "reporters": [
            {
              "id": "1404954043",
              "firstName": "",
              "privateProfile": false,
              "gender": "female",
              "countryCode": "US",
              "relationship": "self",
              "photo": {
                "prefix": "https://fastly.4sqi.net/img/user/",
                "suffix": "/blank_girl.png",
                "default": true
              },
              "homeCity": ""
            }
          ],
          "resolvedTime": "Fri Dec 22 15:43:29 UTC 2023",
          "resolvedUsers": [],
          "app": {
            "id": "HWFY2JZIMBMY1KD0GOYCIVHZWP0UC2I0EL4LRY2J0HLRFRT4",
            "name": "MDT Testing",
            "detailUrl": "https://foursquare.com/app/mdt-testing/HWFY2JZIMBMY1KD0GOYCIVHZWP0UC2I0EL4LRY2J0HLRFRT4"
          },
          "canonicalPath": "/edit/tips?id=6585aea129b1872b7ff5ed82&mode=all",
          "dateTime": "December 22, 2023",
          "reason": "spam_tip",
          "value": {
            "id": "6515f99d8f151130670423d4",
            "createdAt": 1695938973,
            "text": "here is puppy number 2",
            "type": "user",
            "canonicalUrl": "https://foursquare.com/item/6515f99d8f151130670423d4",
            "photo": {
              "id": "6515f99e2425d010750f76fd",
              "createdAt": 1695938974,
              "prefix": "https://fastly.4sqi.net/img/general/",
              "suffix": "/7294631_VJqOKo4P9-W0VyQk0iOZZzqG178RAL1rswe4KpZ2YGg.png",
              "width": 480,
              "height": 650,
              "visibility": "public"
            },
            "photourl": "https://fastly.4sqi.net/img/general/original/7294631_VJqOKo4P9-W0VyQk0iOZZzqG178RAL1rswe4KpZ2YGg.png",
            "logView": true,
            "agreeCount": 0,
            "disagreeCount": 0,
            "todo": {
              "count": 0
            },
            "user": {
              "id": "1234567",
              "firstName": "Bat",
              "lastName": "Macumba",
              "handle": "batm1234567",
              "privateProfile": false,
              "gender": "male",
              "countryCode": "US",
              "followingRelationship": "none",
              "photo": {
                "prefix": "https://fastly.4sqi.net/img/user/",
                "suffix": "/blank_boy.png",
                "default": true
              }
            }
          }
        }
      ]
    }
  }
}

Example cURL Command

curl --request POST \
     --url https://api.foursquare.com/v2/tips/tip_id/flag \
     --header 'accept: application/json'