RoscoLive API v1.0(v2.37.0)
  1. Geotab
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
        GET
    • 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 metadata of devices
    • Get alerts of a driver
  1. Geotab

Get device by geotab device serial number

Pending
GET
/geotab/devices/{serial_numbers}
Returns devices by Geotab device serial numbers.

Request

Path Params

Query Params

Responses

🟢200Success
application/json
Body

🟠401Login Required
🟠404Resource Not Found
🔴500Internal Server Error
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET '/geotab/devices/?include_data'
Response Response Example
200 - Example 1
{
    "meta": {
        "code": 200
    },
    "response": {
        "devices": [
            {
                "activated_timestamp": "Fri, 11 Jun 2021 18:20:38 GMT",
                "active": true,
                "adas_camera_height": 150,
                "adas_camera_offset": 8,
                "adas_units": "metric",
                "adas_vehicle_hood_len": 191,
                "adas_vehicle_width": 190,
                "ads_online": false,
                "asset_id": 446,
                "canbus": "0",
                "channel_available": "1,2,3",
                "config_checksum": 38276,
                "created_at": "Fri, 11 Jun 2021 18:17:24 GMT",
                "data_limit": 1,
                "data_threshold_type": "company",
                "data_usage": 2217692215,
                "data_usage_live_stream": 24415066,
                "device_id": "51794261",
                "device_type": "dv4",
                "disable_live_stream": false,
                "driver_last_update": "Mon, 07 Jul 2025 22:33:14 GMT",
                "driver_recognition": "company_setting",
                "firmware": "v2.8.1",
                "firmware_status": "firmware out of date",
                "flood_blocked": false,
                "general_status": "sleep",
                "geotab": {
                    "serial_number": "G99FMXWKKHW7",
                    "status_tag": null
                },
                "groups": [
                    "Brians Test Group"
                ],
                "ignition": false,
                "ignition_change": {
                    "state": false,
                    "ts": "2025-10-18 15:04:15"
                },
                "installed_id": null,
                "last_connected_ts": "Mon, 25 Aug 2025 18:37:26 GMT",
                "last_disconnected_ts": "Mon, 25 Aug 2025 18:45:40 GMT",
                "last_sleep_connected_ts": "Mon, 25 Aug 2025 18:45:51 GMT",
                "last_sleep_disconnected_ts": "Mon, 25 Aug 2025 18:31:11 GMT",
                "live_online": false,
                "live_stream": {
                    "duration_month": 833,
                    "live_stream_access": true
                },
                "modem_rssi": "-69",
                "no_sd_card": false,
                "online_gps": false,
                "parking_duration": 120,
                "pending_company_profile": "mike's profile",
                "profile_id": 13845,
                "serial_number": "015974000000538",
                "sleep": 1,
                "status": "used",
                "tag_plate": null,
                "timezone": "US/Eastern",
                "vehicle_icon": "taxi",
                "vehicle_name": "Brian_DV6",
                "vin_number": null
            },
            {
                "activated_timestamp": "Fri, 08 Oct 2021 15:34:51 GMT",
                "active": true,
                "adas_camera_height": 170.18,
                "adas_camera_offset": 0,
                "adas_units": "imperial",
                "adas_vehicle_hood_len": 177.8,
                "adas_vehicle_width": 180.34,
                "ads_online": false,
                "asset_id": 462,
                "canbus": "0",
                "channel_available": "1,2",
                "config_checksum": 2,
                "created_at": "Fri, 08 Oct 2021 15:26:33 GMT",
                "data_limit": 1,
                "data_threshold_type": "company",
                "data_usage": 0,
                "data_usage_live_stream": 0,
                "device_id": "3868616673",
                "device_type": "dv6",
                "disable_live_stream": false,
                "driver_last_update": "Mon, 07 Jul 2025 10:57:47 GMT",
                "driver_recognition": "company_setting",
                "firmware": "v2.8.0",
                "firmware_status": "firmware update pending to dv6_v2.8.1.fw",
                "flood_blocked": false,
                "general_status": "offline",
                "geotab": {
                    "serial_number": "000-000-0000",
                    "status_tag": "{\"tag\":\"Test\",\"color\":\"#4A86E8\"}"
                },
                "groups": [
                    "EngineeringDV6"
                ],
                "ignition": null,
                "ignition_change": {},
                "installed_by_user_id": 1321,
                "installed_id": null,
                "last_connected_ts": "Wed, 09 Jul 2025 12:04:38 GMT",
                "last_disconnected_ts": "Wed, 09 Jul 2025 13:03:09 GMT",
                "last_sleep_connected_ts": "Sun, 29 Jun 2025 00:17:41 GMT",
                "last_sleep_disconnected_ts": "Sun, 29 Jun 2025 00:46:34 GMT",
                "live_online": false,
                "live_stream": {
                    "duration_month": 0,
                    "live_stream_access": true
                },
                "modem_rssi": null,
                "no_sd_card": false,
                "online_gps": false,
                "parking_duration": 60,
                "pending_company_profile": "Manual",
                "profile_id": 0,
                "serial_number": "015974000194984",
                "silence_err_notifs": "SD20",
                "sleep": 0,
                "status": "used",
                "status_tag": "{\"tag\":\"Test\",\"color\":\"#4A86E8\"}",
                "tag_plate": null,
                "timezone": "US/Eastern",
                "vehicle_icon": "chopper",
                "vehicle_name": "Sergey DV6",
                "vin_number": "Sergey DV6"
            }
        ]
    },
    "result": "OK"
}
Modified at 2025-10-20 14:16:08
Previous
Get companies
Next
Update a device settings
Built with