GDPR Deleted Device IDs API

As a participant in AppLovin’s auction, and as a party to a DPA signed with AppLovin, you acknowledged that you will promptly delete any personal data when a 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, make an HTTP GET request to the list API. This enables you to comply with GDPR.

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
  }
}