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

Inspect device endpoint

Use the Inspect device endpoint to see information about a device. Provide your app ID and your device's advertising ID to return device and tracker information relating to the app.

Before you begin

To use this endpoint, you need an Adjust API token. Follow the instructions in the authentication guide to get your token.

Endpoint

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

GET request

Return device information as a JSON object.

Parameters

Parameter	Data type	In	Description
`app_token`*	String	Query	Your app's 12 digit identifier.
`advertising_id`*	String	Query	The device's unique advertising ID: `idfa` (iOS devices) `gps_adid` (Google advertising ID) `android_id` (Android ID) `fire_adid` (Amazon Fire ID) `win_adid` (Windows advertising ID)

Response

{
     "Adid": "string",
     "AdvertisingId": "string",
     "Tracker": "string",
     "TrackerName": "string",
     "ClickTime": "date-time",
     "InstallTime": "date-time",
     "LastSessionTime": "date-time",
     "LastEventTimes": {
           "string": "date-time",
           "string": "date-time",
           "string": "date-time",
           "string": "date-time"},
     "State": "string"
}

Values

Value	Data type	Description
`Adid`	String	The device's Adjust ID.
`AdvertisingId`	String	The device's advertising ID.
`Tracker`	String	The token of the tracker to which the device is attributed.
`TrackerName`	String	The name of the tracker to which the device is attributed.
`ClickTime`	String (date-time)	The timestamp at which the user clicked the tracker link.
`InstallTime`	String (date-time)	The timestamp at which the user installed the app.
`LastSessionTime`	String (date-time)	The timestamp of the last recorded session.
`LastEventTimes`	Object (String, String (date-time))	An object containing a list of event IDs and the timestamp at which they were last triggered.
`State`	String (date-time)	The current attribution state. Possible values are: `installed` `reattributed`

Example

cURL

curl --location --request GET "https://api.adjust.com/device_service/api/v1/inspect_device?advertising_id=1234-5678-9012-3456&app_token=gwzpeepw8uf8" \
--header "Authorization: Bearer ask43jskdp2tg2hg87"

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