# 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
```bash
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
```json
{
  "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