List of Devices
GET {{device_url}}/devices?deviceTypeId=4602978&operatingSystemId=4610163&manufacturerId=4610164&offset=0&limit=10&sortOrder=asc
Retrieve a list of devices
You can retrieve all of the devices recorded in your market by sending this GET request.
The device ids returned in the response body can be used to define fields within the following Campaign Service requests:
-
POSTNew LI -devices(DTO)
Request Params
| Key | Datatype | Required | Description |
|---|---|---|---|
deviceTypeId | number | Limits response results to devices of the device type specified. |
Value can be retrieved from GET List of Device Types. |
| operatingSystemId | number | | Limits response results to devices using the operating system specified.
Value can be retrieved from GET List of OS's. |
| manufacturerId | number | | Limits response results to devices from the manufacturer specified.
Value can be retrieved from GET List of Manufacturers. |
| offset | number | | The starting index in the list of devices. |
| limit | number | | The number of devices to return. |
| sortOrder | string | | Direction of result sorting (by name).
Allowed values: asc, desc |
RESPONSES
status: OK
{"totalNum":35,"data":[{"id":"205202","resourceType":"device","name":"iPhone","deviceTypeId":"4602978","manufacturerId":"4610164","operatingSystemId":"4610163"},{"id":"51828799","resourceType":"device","name":"iPhone 11","deviceTypeId":"4602978","manufacturerId":"4610164","operatingSystemId":"4610163"},{"id":"51828726","resourceType":"device","name":"iPhone 11 Pro","deviceTypeId":"4602978","manufacturerId":"4610164","operatingSystemId":"4610163"},{"id":"51828653","resourceType":"device","name":"iPhone 11 Pro Max","deviceTypeId":"4602978","manufacturerId":"4610164","operatingSystemId":"4610163"},{"id":"61188837","resourceType":"device","name":"iPhone 12","deviceTypeId":"4602978","manufacturerId":"4610164","operatingSystemId":"4610163"},{"id":"61188663","resourceType":"device","name":"iPhone 12 Mini","deviceTypeId":"4602978","manufacturerId":"4610164","operatingSystemId":"4610163"},{"id":"61188779","resourceType":"device","name":"iPhone 12 Pro","deviceTypeId":"4602978","manufacturerId":"4610164","operatingSystemId":"4610163"},{"id":"61188721","resourceType":"device","name":"iPhone 12 Pro Max","deviceTypeId":"4602978","manufacturerId":"4610164","operatingSystemId":"4610163"},{"id":"65932080","resourceType":"device","name":"iPhone 13","deviceTypeId":"4602978","manufacturerId":"4610164","operatingSystemId":"4610163"},{"id":"65932128","resourceType":"device","name":"iPhone 13 Pro","deviceTypeId":"4602978","manufacturerId":"4610164","operatingSystemId":"4610163"}],"errors":[],"links":{"self":"https://services.amobee.com/device/v1/api/devices?deviceTypeId=4602978\u0026operatingSystemId=4610163\u0026manufacturerId=4610164\u0026offset=0\u0026limit=10\u0026sortOrder=asc","next":"https://services.amobee.com/device/v1/api/devices?deviceTypeId=4602978\u0026operatingSystemId=4610163\u0026manufacturerId=4610164\u0026offset=10\u0026limit=10\u0026sortOrder=asc"}}