We constantly publish updates to our documentation, which may not yet be available in your language. For the most current information, use the English version.

for Developers

GDPR API reference

Adjust offers an API endpoint to facilitate erasure requests. This endpoint performs the following actions for a given device:

Permanently deletes all of the user’s personal data from Adjust for the specified app.
Stops receiving the user’s/device's information from the Adjust SDK for the specified app.
Removes all references to the user's/device's data in the Adjust dashboard for the specified app.

Configure your server to send requests to this API endpoint when users send erasure requests. See our Right to erasure article for more information about erasure requests.

Important:

This action is permanent. Adjust can't reinstate data previously associated with a device or receive future requests from the device once an erasure request is sent.

Endpoint

https://gdpr.adjust.com/gdpr_forget_device

POST request

Send a POST request including your app token and device ID to remove all data associated with the device.

Note:

Erasure requests only apply to the app you specify in your call. Device data for other apps are not affected.

Parameters

Parameter	Data type	In	Value description	Required?
`app_token`	String	Query	The Adjust app token from the dashboard.	Yes
`s2s`	Boolean	Query	Whether the call is a Server-to-Server (S2S call). Value must be `1` (true).	Yes
`<device_token>`	String	Query	ID of the device you want Adjust to forget. See the table below for a list of accepted values.	Yes

Device identifiers

You must include a device identifier in your request. Below is a list of accepted identifiers.

Parameter	Data type	In	Example value	Value description
`idfa`	String	Query	`8C6CBCOD-5F43-4765-A6E6-84DFF3D24707`	iOS ID for advertisers.
`idfv`	String	Query	`CCB300A0-DE1B-4D48-BC7E-599E453B8DD4`	iOS ID for vendors.
`gps_adid`	String	Query	`38400000-8cf0-11bd-b23e-10b96e40000d`	Google Play Store advertising ID.
`fire_adid`	String	Query	`63c5519b-7e66-7ee6-aa5d-3b290743811f`	Fire OS advertising ID.
`win_adid`	String	Query	`107e8ea14329d4a2194ebbb6dc0c0fd7`	Windows advertising ID.
`adid`	String	Query	`18546f6171f67e29d1cb983322ad1329`	Adjust device ID.

Example

cURL

curl -X POST "https://gdpr.adjust.com/gdpr_forget_device?s2s=1&app_token=kwrqhymtnsr2&idfa=9C5CBC1D-4F42-4764-A5E6-84DAF3D24707"

Response

Status code	Meaning	Description
`200`	OK	Request was received and processed.
`400`	Bad request	Invalid formatting or token. Check you have included the necessary parameters. Contact your account manager or support@adjust.com if you need help.
`429`	Too many requests	The endpoint is rate limited to 10 requests per minute and stops responding to requests beyond this threshold to prevent abuse. Try resending the request later.
`451`	Unavailable for legal reasons