Downloading history data from nRF Cloud

[JackW]

At one time is was possible to download a history file for an nRF9160 device connected to the nRF Cloud that had the following json structure:

{
"topic": "prod/51789c46-81ce-4872-b9b8-e7efa03adf21/m/d/rIoT-351358811013801/d2c",
"deviceId": "rIoT-351358811013801",
"receivedAt": "2023-07-15T00:14:24.999Z",
"message": {
"appId": "GNSS",
"messageType": "DATA",
"ts": 1689380064999,
"data": {
"lng": -123.08815569538295,
"lat": 49.33025801914223,
"acc": 14.499619483947754,
"alt": 55.98991775512695,
"spd": 14.036337852478027,
"hdg": 3.507920742034912
}
},
"tenantId": "51789c46-81ce-4872-b9b8-e7efa03adf21"
},
{
"topic": "prod/51789c46-81ce-4872-b9b8-e7efa03adf21/m/d/rIoT-351358811013801/d2c",
"deviceId": "rIoT-351358811013801",
"receivedAt": "2023-07-15T00:14:18.956Z",
"message": {
"appId": "RSRP",
"messageType": "DATA",
"ts": 1689380058956,
"data": "-94"
},
"tenantId": "51789c46-81ce-4872-b9b8-e7efa03adf21"
},

The option to download a history file in this format doesn't seem available anymore, or at least I can't find it on the nRF Cloud site.  Is there still a way to get history data in this format? Please advise.

Thanks

Jack

[Cole Hafner]

Hi Jack,

You can download your messages via the REST API: https://api.nrfcloud.com/v1#tag/Messages/operation/ListMessages 

Give that a try and let me know how it works out. 

Thanks,

Cole

[JackW]

OK, so would I structure my GET like this: api.nrfcloud.com/.../messages

[Cole Hafner]

Hi Jack,

The endpoint you're referencing will fetch the device details (see docs). What you're trying to do, I believe, is fetch messages for your device. For that you will need to use the /messages endpoint with the format I mentioned before:

api.nrfcloud.com/v1/messages?deviceId=<deviceId>

This will list all messages stored by the device. 

[JackW]

Yep, that worked - thx

[JackW]

And how do I specify a date range?

[Nate Sherrett]

Hi Jack,

To specify a date range you can use the query parameters of start and end that both take an ISO Date-time string.

Ex:

start=2024-05-28T00:38:48.941Z

end=2024-05-29T00:38:48.941Z

api.nrfcloud.com/v1/messages?deviceId=<deviceId>&start=2024-05-28T00:38:48.941Z&end=2024-05-29T00:38:48.941Z

[JackW]

Great!!  Thanks