API Documentation

fsq_place_id

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

dry_run

Type: boolean
Default: true
If true, return the expected result without actually submitting the suggestion. Useful for testing.

Note this defaults to false in all cases EXCEPT when calling through this docs page.

duplicate_fsq_place_ids

Type: string
Required: Yes
A list of string identifiers that represent the same place as the given fsq_place_id.

X-Places-Api-Version

Type: string
Enum:
Required: Yes
Defaults to 2025-06-17
The version of the API to use.

Allowed:

2025-06-17

Response

``200 success

Type: object

suggested_edits

Type: array of objects

• id: string
• fsq_place_id: string
• suggested_edit_type: string
• created_at: date-time
• resolved_time: date-time
• rolled_back: object
• status: string
• created_fsq_place_id: string
• matched_fsq_place_id: string

errors

Type: array of strings

Example Request

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

Example Response

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

Updated3 days ago