Getting device data on all devices or a specific audience

Device data for a known device

If you are looking to get the device data for a specific known device, you can utilize the Device Log and search for a specific device. In the Carnival dashboard, navigate to Settings, then Logs.


You can search for a Device ID (for example, you can use Charles to identify your Device ID), Device Alias (if one was previously set on the device), or the User ID (if this is being set on devices). It is required to know one of these details about the device to find them within the Device Log.

The Device ID is located within the Device Log. After clicking on any device in the log, the Device ID is a blue alpha-numeric string located at the top of the device profile next to the device the user is using:




Device data for all devices or a specific audience

If there is a specific audience segment you would like device data on or if you are looking for device data for all devices, you can do this with a combination of the Audience tool and the API. 

  1. First create your segment of users. From the Audience page, click the Create Audience button.
    • If you are looking for a specific segment (for example: devices that are located in New York, NY), apply the related Audience filters to segment the devices.
    • If you are looking for device data on all devices, create an Audience with no Filters. An Audience without any filters will automatically pull in all devices.
    • Screen_Shot_2017-05-24_at_3.41.32_PM.png
  2. Once the audience is created, utilize the Audiences / Device API to return a paginated list of devices belonging to an audience and the data of those devices.


Sample Result: 


  "meta": {
    "cursor": "c2Nhbjs1OzMwNTp1MllsUzNyOFFyS19RMkFNLWdVekxnOxfaGl0czo5Ow==",
    "total": 15000
  "devices": [
      "id": "123",
      "user_id": "",
      "push_enabled": true,
      "push_token": "d35c15ee345d07f42016738323aa4818e4deacd6****f54dea932a677",
      "platform": "iOS",
      "last_opened": "2016-11-23T20:31:03.000Z",
      "user_attributes": {
        "age": {
          "type": "integer",
          "value": 30
        "height": {
          "type": "float",
          "value": 1.75
        "birthdate": {
          "type": "date",
          "value": "1985-05-01T00:00:00Z"
        "vip": {
          "type": "boolean",
          "value": true
        "favorite_color": {
          "type": "string",
          "value": "blue"
      "user_events": {
        "purchase_unlocked": {
          "count": 10,
          "first_happened_at": "2016-05-23T04:12:34.173Z",
          "last_happened_at": "2016-05-24T04:12:34.173Z"
      "location": {
        "gps": {
          "lat": "-41.12345",
          "lng": "174.12345"
        "geoip": {
          "lat": "-41.0",
          "lng": "174.0",
          "city": "Wellington",
          "country": "New Zealand"