GDPR Deleted Device IDs API

  • Updated

As a participant in AppLovin’s auction, and as a party to a DPA signed with AppLovin, you have acknowledged that you will promptly delete any Personal Data where such person has requested deletion. These deletions must be done no less frequently than on a weekly basis. AppLovin recommends that you automate the deletion process by means of this API, preferably on a daily basis.

The available API is:

Endpoint Purpose
list_idfa List device advertising IDs for which, in a given period of time, the owner of the device requested deletion of personal data.

Authentication

The GDPR API requires your GDPR API key in the api_key parameter of the request. You can find your GDPR API key in your AppLovin account (Account > General > Keys).

Building the Query

To get a list of all device IDs for which the device owner requested information deletion, for GDPR compliance, make an HTTP GET request to the list API:

https://api.applovin.com/gdpr_dsp/list_idfa

Query Parameters

Name Type Description Required
api_key String DSP GDPR API Key Yes
start_date Date Valid Format is YYYY-MM-DD. Maximum look-back window is seven days. No
end_date Date Valid Format is YYYY-MM-DD No

Response

Name Type Description
code Integer 200 for success
identifiers List of Objects A list of all device IDs that the device owners requested to be deleted

Errors

This API uses HTTP status codes to indicate errors:

HTTP Response Code Description
200 Success.
400 Request is not formatted properly, is missing data, or has an invalid date range specified.
403 Authentication failed. Check the validity of the API Key.
500 Service is unavailable.

Example Request

curl https://api.applovin.com/gdpr_dsp/list_idfa?api_key=your-GDPR-API-key

With date range:

curl https://api.applovin.com/gdpr_dsp/list_idfa?api_key=your-GDPR-API-key&start_date=2018-07-20&end_date=2018-07-27

Example Response

{
  {
  "code": 200,
  "identifiers": [
    {
      "identifier": "03464f18-0657-4823-ba98-3d92a8b8e44a"
    },
    {
      "identifier": "0576a8c3-735a-479a-9fdd-47c20c7b74a0"
    },
    {
      "identifier": "0b20fdb7-8cc7-4dd3-9c34-803b4ebb7fcd"
    },
    {
      "identifier": "0ee90410-5b07-4fca-b9b2-eaab0d9670c9"
    },
    {
      "identifier": "1195ff98-6b12-482f-83ef-095f51e46a70"
    },
    {
      "identifier": "18bd1239-434a-412b-9bf3-c4bb621db66b"
    },
    {
      "identifier": "241d6332-4d86-4b18-b03e-b3072adaa8c5"
    },
    {
      "identifier": "29a24673-b0a8-4ac0-862b-15f3abbfc3c3"
    }
  ],
  "count": 8
 }
}