Requests for Data Deletion

Overview

To facilitate requests for deletion exercised under applicable privacy and data protection laws, we have made the following endpoint available to you to request removal of a user's data from our servers. This endpoint will allow you to submit deletion requests directly from your application.

Install IDs

This endpoint requires the submission of the installId associated with the accounts you would like removed. These install ids have been provided to you by Pilgrim and starting May 25th, 2018 it is your responsibility as the app developer to provide these install ids to Foursquare for the removal of a user's data. An example install id would be: 2B82C786-7BB8-4601-9A86-372417AAD4AC

A successful request will return a 200 response code and a 400 will be returned for invalid install ids.

Endpoint Description

Request

POST https://api.foursquare.com/v2/apps/CLIENT_ID/erasureRequest

Authentication

A valid oauth_token of an authorized administrator of the Foursquare application. A guide on how to generate this token can be found here.

Parameters

NameExampleDescription
installId2B82C786-7BB8-4601-9A86-372417AAD4ACrequired A comma separated string of installation UUIDs.

Response

{
  "meta": {
    "code": 200,
    "requestId": "5b06e2624434b978253ff6b3"
  },
  "notifications": [
    {
      "type": "notificationTray",
      "item": {
        "unreadCount": 0
      }
    }
  ],
  "response": {}
}

📘

Bulk Upload Available via Your Developer Console

You can also submit Data Erasure requests within your Developer Console. Enter up to 1000 Pilgrim SDK Install IDs.

Learn More

Sign In