Reports/History Endpoint
Table of Contents
Reports/History Endpoint
You can query old reports from your devices, sensors and tracked users.
Get all reports after a timestamp
GET https://api.corvusgps.com/reports/history/4/from:1667510000/
{
"features": [
{
"type": "Feature",
"properties": {
"aid": 0,
"did": 4,
"name": "\"Steve\"",
"availability": "available",
"lat": 37.80551,
"lng": -122.41469,
"alt": 0,
"speed": 43,
"heading": 80,
"source": "gps",
"address": null,
"date": 1667510025,
"battery": 100,
"odometer": null,
"precision": 13,
"satellites": 0,
"temperature": null,
"reportType": "report",
"reportValue": "",
"message": ""
},
"geometry": {
"type": "Point",
"coordinates": [
-122.41469,
37.80551
]
}
},
{
"type": "Feature",
"properties": {
"aid": 0,
"did": 4,
"name": "\"Steve\"",
"availability": "available",
"lat": 37.80571,
"lng": -122.41311,
"alt": 0,
"speed": 48,
"heading": 80,
"source": "gps",
"address": null,
"date": 1667510092,
"battery": 100,
"odometer": null,
"precision": 13,
"satellites": 0,
"temperature": null,
"reportType": "report",
"reportValue": "",
"message": ""
},
"geometry": {
"type": "Point",
"coordinates": [
-122.41311,
37.80571
]
}
},
"success": "Reports have been successfully retrieved."
}
Get all reports between timestamps
GET https://api.corvusgps.com/reports/history/4/from:1667510000/to:1667520000/
{
"features": [
{
"type": "Feature",
"properties": {
"aid": 0,
"did": 4,
"name": "\"Steve\"",
"availability": "available",
"lat": 37.80551,
"lng": -122.41469,
"alt": 0,
"speed": 43,
"heading": 80,
"source": "gps",
"address": null,
"date": 1667510025,
"battery": 100,
"odometer": null,
"precision": 13,
"satellites": 0,
"temperature": null,
"reportType": "report",
"reportValue": "",
"message": ""
},
"geometry": {
"type": "Point",
"coordinates": [
-122.41469,
37.80551
]
}
},
{
"type": "Feature",
"properties": {
"aid": 0,
"did": 4,
"name": "\"Steve\"",
"availability": "available",
"lat": 37.80571,
"lng": -122.41311,
"alt": 0,
"speed": 48,
"heading": 80,
"source": "gps",
"address": null,
"date": 1667510092,
"battery": 100,
"odometer": null,
"precision": 13,
"satellites": 0,
"temperature": null,
"reportType": "report",
"reportValue": "",
"message": ""
},
"geometry": {
"type": "Point",
"coordinates": [
-122.41311,
37.80571
]
}
},
"success": "Reports have been successfully retrieved."
}
Get all reports that arrived late after a query time
GET https://api.corvusgps.com/reports/history/4/lastQueryTime:1667510590/
{
"features": [
{
"type": "Feature",
"properties": {
"aid": 0,
"did": 4,
"name": "\"Steve\"",
"availability": "available",
"lat": 37.80551,
"lng": -122.41469,
"alt": 0,
"speed": 43,
"heading": 80,
"source": "gps",
"address": null,
"date": 1667510025,
"battery": 100,
"odometer": null,
"precision": 13,
"satellites": 0,
"temperature": null,
"reportType": "report",
"reportValue": "",
"message": ""
},
"geometry": {
"type": "Point",
"coordinates": [
-122.41469,
37.80551
]
}
},
{
"type": "Feature",
"properties": {
"aid": 0,
"did": 4,
"name": "\"Steve\"",
"availability": "available",
"lat": 37.80571,
"lng": -122.41311,
"alt": 0,
"speed": 48,
"heading": 80,
"source": "gps",
"address": null,
"date": 1667510092,
"battery": 100,
"odometer": null,
"precision": 13,
"satellites": 0,
"temperature": null,
"reportType": "report",
"reportValue": "",
"message": ""
},
"geometry": {
"type": "Point",
"coordinates": [
-122.41311,
37.80571
]
}
},
"success": "Reports have been successfully retrieved."
}
Get all reports between timestamps that arrived after our last query
GET https://api.corvusgps.com/reports/history/4/from:1667510000/to:1667520000/lastQueryTime:1667510590
{
"features": [
{
"type": "Feature",
"properties": {
"aid": 0,
"did": 4,
"name": "\"Steve\"",
"availability": "available",
"lat": 37.80551,
"lng": -122.41469,
"alt": 0,
"speed": 43,
"heading": 80,
"source": "gps",
"address": null,
"date": 1667510025,
"battery": 100,
"odometer": null,
"precision": 13,
"satellites": 0,
"temperature": null,
"reportType": "report",
"reportValue": "",
"message": ""
},
"geometry": {
"type": "Point",
"coordinates": [
-122.41469,
37.80551
]
}
},
{
"type": "Feature",
"properties": {
"aid": 0,
"did": 4,
"name": "\"Steve\"",
"availability": "available",
"lat": 37.80571,
"lng": -122.41311,
"alt": 0,
"speed": 48,
"heading": 80,
"source": "gps",
"address": null,
"date": 1667510092,
"battery": 100,
"odometer": null,
"precision": 13,
"satellites": 0,
"temperature": null,
"reportType": "report",
"reportValue": "",
"message": ""
},
"geometry": {
"type": "Point",
"coordinates": [
-122.41311,
37.80571
]
}
},
"success": "Reports have been successfully retrieved."
}
Filtering the results by reportTypes
The default value is all, when the filter is omitted.
Possible values: report, reporting_mode, availability, battery_state, check_in, crash, doze, external_power, gps_fix, job_state, motion_state, note, reporting_state, sensor, sos
GET https://api.corvusgps.com/reports/history/4/from:1667510000/to:1667520000/reportTypes:report,sos,crash,check_in/
{
"features": [
{
"type": "Feature",
"properties": {
"aid": 0,
"did": 4,
"name": "\"Steve\"",
"availability": "available",
"lat": 37.80551,
"lng": -122.41469,
"alt": 0,
"speed": 43,
"heading": 80,
"source": "gps",
"address": null,
"date": 1667510025,
"battery": 100,
"odometer": null,
"precision": 13,
"satellites": 0,
"temperature": null,
"reportType": "report",
"reportValue": "",
"message": ""
},
"geometry": {
"type": "Point",
"coordinates": [
-122.41469,
37.80551
]
}
},
{
"type": "Feature",
"properties": {
"aid": 0,
"did": 4,
"name": "\"Steve\"",
"availability": "available",
"lat": 37.80571,
"lng": -122.41311,
"alt": 0,
"speed": 48,
"heading": 80,
"source": "gps",
"address": null,
"date": 1667510092,
"battery": 100,
"odometer": null,
"precision": 13,
"satellites": 0,
"temperature": null,
"reportType": "report",
"reportValue": "",
"message": ""
},
"geometry": {
"type": "Point",
"coordinates": [
-122.41311,
37.80571
]
}
},
"success": "Reports have been successfully retrieved."
}