---
title: "Data Packet Format"
canonical: "https://help.scopious.co.nz/space/KB/263847944/Data%20Packet%20Format"
format: markdown
---
Below is a typical example of a JSON formatted uplink data packet that you can expect to receive.

Uplink packets are decrypted at the network server and so will arrive unencrypted.

When processing the packet, there are 4 key fields to be aware of:

1. `end_device_ids.dev_eui` - The unique id of the device. This should be used to identify the device.
2. `uplink_message.received_at` - ISO 8601 UTC timestamp at which time the uplink was received by the network server.
3. `uplink_message.frm_payload` - The raw payload transmitted by the device. Use this field if you wish to format the payload yourself. The value is Base64 encoded so will need to be decoded before it can be used.
4. `uplink_message.decoded_payload.xxx` - The formatted payload fields. If the device is not a [pre-approved device](https://scopious.atlassian.net/wiki/spaces/KB/pages/21331980) or it belongs to a **Standard** device pool, then these fields may not be present.

Example uplink data packet (id’s have been redacted for confidentiality):

```
{
  "end_device_ids": {
    "device_id": "***",
    "application_ids": {
      "application_id": "***"
    },
    "dev_eui": "***",
    "join_eui": "***",
    "dev_addr": "***"
  },
  "correlation_ids": [
    "gs:uplink:01JKF8CDWZYMX1P767F8N4H88A"
  ],
  "received_at": "2025-02-07T03:48:45.807801054Z",
  "uplink_message": {
    "session_key_id": "***",
    "f_port": 85,
    "f_cnt": 18,
    "frm_payload": "AXU/A2fqAARoXgd9FAI=",
    "decoded_payload": {
      "battery": 63,
      "co2": 532,
      "humidity": 47,
      "temperature": 23.4
    },
    "rx_metadata": [
      {
        "gateway_ids": {
          "gateway_id": "***",
          "eui": "***"
        },
        "time": "2025-02-07T03:48:45.374901056Z",
        "timestamp": 671846945,
        "rssi": -92,
        "channel_rssi": -92,
        "snr": 13.5,
        "uplink_token": "***",
        "received_at": "2025-02-07T03:48:45.576267816Z"
      }
    ],
    "settings": {
      "data_rate": {
        "lora": {
          "bandwidth": 125000,
          "spreading_factor": 7,
          "coding_rate": "4/5"
        }
      },
      "frequency": "923400000",
      "timestamp": 671846945,
      "time": "2025-02-07T03:48:45.374901056Z"
    },
    "received_at": "2025-02-07T03:48:45.600143844Z",
    "consumed_airtime": "0.066816s",
    "locations": {
      "user": {
        "latitude": ***,
        "longitude": ***,
        "source": "SOURCE_REGISTRY"
      }
    },
    "network_ids": {
      "net_id": "000013",
      "ns_id": "EC656E0000000183",
      "tenant_id": "ttn",
      "cluster_id": "au1",
      "cluster_address": "au1.cloud.thethings.network"
    },
    "last_battery_percentage": {
      "f_cnt": 2,
      "value": 62.845848,
      "received_at": "2025-02-07T02:43:27.557727968Z"
    }
  }
}
```

To understand the content of other fields in the packet, you can find more information in the TTI documentation [here](https://www.thethingsindustries.com/docs/integrations/data-formats/#uplink-messages).