Device API

Use the device API to view device information and clear device history from Adjust for testing purposes.

All Adjust APIs are available to clients in or above a Business Pro package.

Inspect device

Use the Adjust device endpoint to inspect device activity.

Endpoint:
https://api.adjust.com/device_service/api/v1/inspect_device

Current version: v1

Requirements:
 
Request headerDefinition
app_token 
Required
The 10 character alphanumeric string identifier assigned to your app within Adjust
advertising_id
Required
The unique advertising identification number assigned to your device. Adjust supports the following identification types: IDFA (iOS); Google Advertising ID (Android); Android ID (Android); Windows Advertising ID (Windows); Fire Advertising ID (Kindle)

Sample request example (using curl):
curl -H "Authorization: Bearer ask43jskdp2tg2hg87" "https://api.adjust.com/device_service/api/v1/inspect_device?advertising_id=1234-5678-9012-3456&app_token=tei4k374ke"

Sample Response:
{
     "Adid": "acf8534f2f052395e617a38730682ccc",
     "AdvertisingId": "1234-5678-9012-3456",
     "Tracker": "abc123",
     "TrackerName": "Organic",
     "ClickTime": "0001-01-01T00:00:00Z",
     "InstallTime": "2015-08-19T03:42:03Z",
     "LastSessionTime": "2017-07-29T17:29:17Z",
     "LastEventTimes": {
           "a1a1a1": "2017-07-29T17:29:55Z",
           "b2b2b2": "2017-07-29T17:29:21Z",
           "c3c3c3": "2017-07-29T17:29:38Z",
           "4d4d4d": "2017-07-29T17:29:58Z"},
     "State": "installed"
}


Response definitions:
PropertyTypeDescription
AdidstringAn Adid is an internal identification number assigned to every Adjust tracked device.
AdvertisingIDstringThe unique device identifier used in original query.
TrackerstringThe tracker token for the device’s current attribution source.
TrackerNamestringThe tracker name for the device’s current attribution source.
ClickTimestringThe click timestamp on record for any device. Any device currently attributed as Organic will have a click timestamp of "0001-01-01T00:00:00Z"
InstallTimestringThe install timestamp on record for any device.
LastSessionTimestringThe timestamp for the the latest session on record.
LastEventTimesstringThe timestamp(s) for the latest event trigger(s), if any.
StatestringThe device’s current attribution state. Possible values: installed; reattributed


Forget device

Use the Adjust forget device endpoint to clear device history from Adjust and test multiple installs on the same device.

Endpoint:
https://api.adjust.com/device_service/api/v1/forget_device

Current version: v1

Requirements:
Request headerDefinition
app_token 
Required
The 10 character alphanumeric identifier assigned to your app within Adjust
adid 
Required
The internal identification number assigned to every Adjust tracked device

Sample request example (using curl):
curl -d "adid=acf8534f2f052395e617a38730682ccc&app_token=tei4k374ke" -X POST -H "Authorization: Token token=ask43jskdp2tg2hg87" "https://api.adjust.com/device_service/api/v1/forget_device"

Sample response:
Forgot device

On this topic