### Private Beta Feature  
This documentation covers a feature currently in Private Beta. Access is exclusive to approved participants. If you're interested in joining the Private Beta program, apply [here](https://location.foursquare.com/products/beta-program/).

Please note that while the docs are publicly viewable, functionality is limited to Private Beta participants until public launch.

**Deliver Rewards to Active Deal Seekers**  
Use our **Movement SDK** to increase trust with your users by delivering rewards at the right place and right time. Surface nearby deals/coupons to promote local businesses, remind users at a store to scan receipts, and notify in-store users of current deals/promotions.

Uncover behavioral shopping patterns of app users, and measure footfall to venues for offline attribution.

Leverage the **Check-in API** to allow customers to actively check into a venue and engage with available discounts.

Take advantage of our **Nearby Venue Search API** to help in-person shoppers discover new stores and products. Provide place and individualized search experiences, with full response schemas including all FSQ place attributes.

## Features Used  
Our retail rewards mobile app use case leverages the following features to achieve the afore-mentioned user experience.

### Movement SDK  
- [Snap to Place Technology](https://location.foursquare.com/developer/docs/movement-sdk-feature-breakdown#place-visit-detection--snap-to-place-technology) to generate visit events and feed the recommendations algorithm
- [Geofences](https://location.foursquare.com/developer/docs/movement-sdk-feature-breakdown#geofencing) for event detection on a specified set of lat/longs, POIs, categories, or chains
- [Custom User Data](https://location.foursquare.com/developer/docs/movement-sdk-feature-breakdown#custom-user-data) to send over metadata unique to your needs
- [3rd Party Integrations](https://location.foursquare.com/developer/docs/movement-sdk-feature-breakdown#third-party-integrations) for Push Notifications
- [Webhooks](https://location.foursquare.com/developer/docs/movement-sdk-feature-breakdown#webhooks) to Send Data to External Sources

### Personalization APIs  
- [Check-in API](https://location.foursquare.com/developer/reference/v2-checkins-add) to enable active user check-ins
- [Nearby Venue Search](https://location.foursquare.com/developer/reference/v2-venues-search) to snap a user to their most likely location
- [Venue Details](https://location.foursquare.com/developer/reference/v2-venues-venue_id) for in-depth details about the venue

## Get Started  
### Step 1. Set up Your FSQ Developer Account  
- [Account Creation](https://location.foursquare.com/developer/docs/movement-sdk-get-started)
- [Movement SDK Access](https://location.foursquare.com/products/movement-sdk/) (click Speak to an Expert)
- [Enable 3rd Party Integration](https://location.foursquare.com/developer/docs/enable-third-party-integrations)
- [Set up Webhooks](https://location.foursquare.com/developer/docs/configure-server-webhooks)
- [Create Service API Key](https://location.foursquare.com/developer/reference/manage-your-service-account-personalized-api)

### Step 2. Install and Configure the Movement SDK  
- [Basic Implementation](https://location.foursquare.com/developer/docs/movement-sdk-ios-get-started)
- Configure Additional Features
  - [Custom User Data](https://location.foursquare.com/developer/docs/movement-sdk-ios-add-features#set-custom-user-data)
  - [Geofences](https://location.foursquare.com/developer/docs/movement-sdk-ios-add-features#receive-geofence-events)

### Step 3. Build the API Calls  
- [Create Managed User](https://location.foursquare.com/developer/reference/create-a-managed-user)
- [Create a Check-in](https://location.foursquare.com/developer/reference/v2-checkins-add)
- [Nearby Venue Search](https://location.foursquare.com/developer/reference/v2-venues-search)
- [Venue Details](https://location.foursquare.com/developer/reference/v2-venues-venue_id)

### Step 4. Integrate API Calls Into Your App Code  
The following code written in Swift for an iOS app provides an example of how to call Foursquare’s Check-in API to allow your app users to check into a venue.

Please make sure to include the unique per app user `oauth_token` to ensure a personalized experience. Learn more about Foursquare’s [User-ful Authentication](https://location.foursquare.com/developer/reference/personalization-apis-authentication).

Swift

```swift
struct HTTPError: Error {
    let statusCode: Int

static let badRequest = HTTPError(statusCode: 400)
    // ... more statuses
}

func checkin() async throws {
    let components = {
      var components = URLComponents(string: "https://api.foursquare.com/v2/checkins/add")!
      components.queryItems = [  
        URLQueryItem(name: "v", value: "20231006"),  
        URLQueryItem(name: "oauth_token", value: "[TOKEN]"),  
        URLQueryItem(name: "venueId", value: "[VENUE_ID]")  
      ]
      return components
    }()

let request = {
      var request = URLRequest(url: components.url!)
      request.httpMethod = "POST"
      return request
    }()

let result = try await URLSession.shared.data(for: request)
    guard let response = result.1 as? HTTPURLResponse, response.statusCode < 400 else {
      throw HTTPError(statusCode: (result.1 as? HTTPURLResponse)?.statusCode ?? HTTPError.badRequest.statusCode)
    }

print(String(data: result.0, encoding: .utf8)!)
}
```

Updated 5 months ago