- Authentication
- Company
- Get Camera Health Errors for Company
- Create a company
- get partner settings
- Get audit logs of a company
- get input sensors notifications of a company
- get ignition notifications of a company
- Get a company by ID
- update a company by ID
- Update company
- search companies
- Get companies list
- Get a company
- Get companies
- get partner companies list
- Get own partner company
- Get profile update devices states
- Get profile update devices
- Export profile updates progress
- Create zone
- Update zone
- Delete zone
- Get zones for company
- Get zone movements
- Get zone movements by vehicle
- Custom Role Permissions
- Device
- Get reported DTCs for devicesGET
- Get pre-selected devicesGET
- Store pre-selected devicesPOST
- Migrate devices to another companyPOST
- Get all device migrations for a companyGET
- Cancel device migrations for a companyPOST
- Get company devicesGET
- Search devicesGET
- Update a device settingsPOST
- get a device data usageGET
- Play in-cab audible alert sound for devicePOST
- get devices data usageGET
- get a company devices by company IDGET
- restart a deviceGET
- Get company devices with modemsGET
- get distanceGET
- get installed report of a deviceGET
- get an installed reportGET
- merge profile with device configPOST
- get audit logs of a deviceGET
- Get list of trip dates for deviceGET
- Get list of trips for passed device and dateGET
- Get a deviceGET
- Get list of company devicesGET
- get device with driver idGET
- create devices (legacy/DV4)PUT
- Create devices (auto-prov/DV4/DV6/DV7)PUT
- get company device using IMEI/SNGET
- check red bubble in manage vehiclesGET
- Bulk device creationPUT
- Get devices for all companies available for userGET
- get list of trip related snapshotsGET
- reset status of sd cardPOST
- get list of all available datesGET
- Get available video list for dateGET
- Replace devicePOST
- get replace history by device idGET
- clear device channel statusPOST
- get camera health error by device idGET
- get camera health definitionsGET
- update camera health error by error idPOST
- update camera health errorsPOST
- Get device list for multiple companiesGET
- Get current activity status of devicesGET
- Get reported DTCs for devices
- Device Firmware
- Driver Scoring / Coaching
- Get driver scans
- Get company drivers list
- get a list of trips
- associate a driver with a trip
- get driver by event_id
- Update a driver
- get driver by trip_photo_id
- Get driver scores
- add driver photo
- Add new driver to company
- remove a driver
- upload a driver from csv file
- Get unknown driver trips
- associate trip with the driver.
- Get company event score weights
- Update company event score weights
- Get drivers coaching events
- Event
- Request Custom Snapshots for Time Range
- Request Custom Event
- Get an Event of a Device by Start Time
- Get an Event by ID and Storage Type
- Get Company Events
- Get Event by Company and ID
- Send an event
- get status of an event
- Request videos of an event
- Get Uploaded Event Videos
- get events summary of devices
- get events summary of a device
- get a company events by company ID
- get status of an event by company ID
- Get Event Snapshots
- get snapshots of an event or alert by company ID
- Get a last device event
- Get Latest Event for Each Device in Company
- get events log of a device
- get dates of events
- get events for charts and graphs
- get events for charts and graphs by company ID
- get an event by company ID
- get events summary of a device by company ID
- request videos of an event by company ID
- get dates of an events by company ID
- get a last event of company device
- clear last event
- get dates of events of a device
- Update Custom Event
- delete an event
- request videos of an alert
- share an event
- Get an event by a permalink
- get geotab events
- Get a last updated event of devices
- download a blocked event
- Get Flagged Company Events
- flag an event
- unflag an event
- generate snapshots
- local geocoding service
- update an event
- Get snapshot/location of event
- Get Device Events for Period
- Request custom video from device
- get snapshot on demand
- Get an event by a permalink hash
- Set Event Label for Event
- Restore event video from archive
- Add users for notification of event restore from archive
- Add event label
- Add user feedback to event
- Get event user feedback
- Get event filters list for date range in company
- Get list of company events
- External Service
- Fleet Configuration
- Group
- get company groups
- add a group
- remove a group
- get devices of a group
- add a device to a group
- remove a device from a group
- get users of a group
- add a user to a group
- remove a user from a group
- get company groups by company ID
- add a device to a group by company ID
- Get devices of a group
- remove a device from a group by company ID
- remove a group by company ID
- add a group by company ID
- add an user to a group by company ID
- get users of a group by company ID
- remove an user from a group by company ID
- edit group
- get groups with ID
- get group of a company by group ID
- Live streaming
- Metadata
- Modem Administration
- Report
- get data usage report
- Get custom report data
- get data usage report by device id
- get list of companies with data usage for date range
- get data usage for active devices for specified companies
- get companies with data usage for date range
- get data usage report for devices in company
- get data tracking report
- Request IFTA report of a company
- Get IFTA report of a company
- Get IFTA report in CSV-file by company
- get all events report
- Get all events report for company
- get vehicle activity report
- get firmware report
- Get event count summary report for company devices
- get driver event breakdown report
- get driver event performance report
- Update custom report
- get custom reports by user email
- get custom report by report id
- put subscribe to a report
- get report subscriptions
- get list of standard reports
- get speeding summary report
- get speeding breakdown report
- get idling summary report
- get idling breakdown report
- Create custom report for user
- Partner Portal
- Releases
- Remote Device Management
- Statistics
- User
- Record map type usage
- Get Company Users
- Get User Info from Email Address
- Update a User's Info
- remove a user
- Get my Own User Info
- Create a User
- Get Users by Company ID
- get user settings
- set user settings
- Get application notifications
- remove the notification
- mark notifications as viewed
- verify password
- SD card reformat reminder
- Update notification by email
- assign user to company
- get permissions by a user_id
- Get event / sms notification settings
- Webhooks
- Asset
- Schemas
get a device data usage
GET
/api/{{API_VERSION}}/partners/devices/{{DEVICE_ID}}/usage
the format of start_date and end_date is YYYYMMDD, eg:20170808
Request
Query Params
Body Params multipart/form-data
Request Code Samples
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --globoff 'https://fleet.roscolive.com/api/v1.0/api/{{API_VERSION}}/partners/devices/{{DEVICE_ID}}/usage?start_date={{START_DATE}}&end_date={{END_DATE}}'Responses
🟢200valid get a device data usage
application/json
Bodyapplication/json
Example
{
"meta": {
"code": 200
},
"response": [
{
"device": {
"device_id": "int",
"groups": "list",
"usage": {
"down_usage": "int",
"live_down_usage": "int",
"live_up_usage": "int",
"storage_down_usage": "int",
"storage_up_usage": "int",
"up_usage": "int"
},
"vehicle_name": "str"
}
}
],
"result": "OK"
}🟠404get a none existing device data usage
🟠400get a device data usage without params
🟠401Login Required
Modified at 2026-04-08 12:11:21