RoscoLive API v1.0(v2.37.0)
  1. Metadata
RoscoLive API v1.0(v2.37.0)
  • Company
    • Create a company
      PUT
    • Get a company by ID
      GET
    • Update company
      POST
    • Get a company
      GET
    • Get companies
      GET
  • Device
    • Geotab
      • Get device by geotab device serial number
    • Update a device settings
      POST
    • Get reported DTCs for devices
      GET
    • Get company devices
      GET
    • Search devices
      GET
    • Play in-cab audible alert sound for device
      POST
    • Get list of trip dates for device
      GET
    • Get list of trips for passed device and date
      GET
    • Get a device
      GET
    • Get devices for all companies available for user
      GET
    • Get available video list for date
      GET
    • Get device list for multiple companies
      GET
  • Driver Scoring / Coaching
    • Get driver scores
      GET
    • Get unknown driver trips
      GET
  • Event
    • Request Custom Event
      PUT
    • Get Company Events
      GET
    • Send an event
      PUT
    • Get snapshot/location of event
      GET
    • Get Device Events for Period
      GET
    • Request custom video from device
      PUT
    • Get event filters list for date range in company
      GET
  • Group
    • Get devices of a group
  • Metadata
    • Get metadata of a device
      GET
    • Get metadata of devices
      GET
    • Get alerts of a driver
      GET
  1. Metadata

Get metadata of devices

GET
/devices/metadata
Returns current metadata values for passed in Device IDs within the duration requested. Time duration is regulated to a maximum of 24 hours. If end_ts not passed into request, duration will default to start_ts + 24h.

Request

Query Params

Responses

🟢200Success
application/json
Body

🟠401Login Required
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET '/devices/metadata?start_ts=&end_ts=&ids=&page_number=&page_size='
Response Response Example
200 - Success
{
    "meta": {
        "code": 200
    },
    "response": [
        {
            "asset_id": 446,
            "device_id": "51794261",
            "driver_name": null,
            "driver_trips": [],
            "driverid_mode": "cardreader",
            "metadata": [
                {
                    "end_ts": "2025-02-03 17:32:47",
                    "event_id": null,
                    "start_ts": "2025-02-03 17:32:47",
                    "type": "CameraBlock"
                },
                {
                    "dir": 181,
                    "dst": 6,
                    "key": "1",
                    "latitude": 40.3453407287598,
                    "longitude": -74.3024215698242,
                    "speed": 4.35,
                    "timestamp": "Mon, 03 Feb 2025 00:05:56 GMT",
                    "type": "Gps"
                },
                {
                    "dir": 0,
                    "dst": 2196,
                    "key": "0",
                    "latitude": 40.3482246398926,
                    "longitude": -74.435791015625,
                    "speed": 0,
                    "timestamp": "Mon, 03 Feb 2025 16:49:52 GMT",
                    "type": "Gps"
                }
            ],
            "vehicle_name": "Brian_DV6"
        },
        {
            "asset_id": 25,
            "device_id": "98293836",
            "driver_name": null,
            "driver_trips": [],
            "driverid_mode": "cardreader",
            "metadata": [
                {
                    "dir": 280,
                    "dst": 1,
                    "key": "1",
                    "latitude": 49.2280158996582,
                    "longitude": 28.4592266082764,
                    "speed": 0,
                    "timestamp": "Mon, 03 Feb 2025 16:36:43 GMT",
                    "type": "Gps"
                },
                {
                    "dir": 280,
                    "dst": 1,
                    "key": "1",
                    "latitude": 49.2280158996582,
                    "longitude": 28.4592266082764,
                    "speed": 0,
                    "timestamp": "Mon, 03 Feb 2025 16:36:48 GMT",
                    "type": "Gps"
                }
            ],
            "vehicle_name": "OfflineMainDeviceForApi"
        }
    ],
    "result": "OK"
}
Modified at 2025-10-24 16:04:59
Previous
Get metadata of a device
Next
Get alerts of a driver
Built with