Flag a Place

FSQ Place ID

A unique string identifier for a FSQ Place (formerly known as Venue ID). E.g., Foursquare HQ's fsq_place_id = 5a187743ccad6b307315e6fe.

Parameters

dry_run

boolean
Defaults to true
If true, return the expected result without actually submitting the suggestion. Useful for testing.

fields

string
required
List of fields being flagged as incorrect. Possible values are:

comment

string
A comment describing the issue being flagged.

X-Places-Api-Version

string
enum
required
Defaults to 2025-06-17
The version of the API to use.

Example Response

{
  "suggested_edits": [
    {
      "id": "string",
      "fsq_place_id": "string",
      "suggested_edit_type": "string",
      "created_at": "2026-07-25T03:23:17.365Z",
      "resolved_time": "2026-07-25T03:23:17.365Z",
      "rolled_back": {},
      "status": "string",
      "created_fsq_place_id": "string",
      "matched_fsq_place_id": "string"
    }
  ],
  "errors": [
    "string"
  ]
}

API Example Request

curl --request POST \
     --url 'https://places-api.foursquare.com/places/fsq_place_id/suggest/flag?dry_run=true' \
     --header 'X-Places-Api-Version: 2025-06-17' \
     --header 'accept: application/json'