# FleetUp API Docs

## Docs
- Quick Start [Your First API Call](https://fleetup-docs.apifox.cn/your-first-api-call-6108462m0.md): 
- Quick Start [Token Expiration](https://fleetup-docs.apifox.cn/token-expiration-6108600m0.md): 
- Quick Start [Rate Limit](https://fleetup-docs.apifox.cn/rate-limit-6108592m0.md): 
- Quick Start [Error Codes](https://fleetup-docs.apifox.cn/error-codes-6108628m0.md): 
- API Reference [Introduction](https://fleetup-docs.apifox.cn/introduction-6108726m0.md): 
- API Guides [Retrieve All Devices from an Enterprise](https://fleetup-docs.apifox.cn/retrieve-all-devices-from-an-enterprise-6109602m0.md): 

## API Docs
- API Reference > Authentication [/token](https://fleetup-docs.apifox.cn/token-265966526e0.md): This API is required to generate a token which will be valid for 3600s.
- API Reference > Authentication [Obtain JWT Token](https://fleetup-docs.apifox.cn/obtain-jwt-token-265966527e0.md): This endpoint generates a JWT-formatted token valid for 3600 seconds. Enterprise users are required to use this endpoint for authentication. The token must be included in the `Authorization` header (e.g., `Bearer <token>`) for subsequent API calls.
- API Reference > Account & User & Device [/account-info](https://fleetup-docs.apifox.cn/account-info-265966528e0.md): Get account specific information like companyName, country, language, timeZone, address, dataModel, usdotNo and rut for a given acctId
- API Reference > Account & User & Device [/users](https://fleetup-docs.apifox.cn/users-265966529e0.md): Get all users. Can be filtered by role query parameter
- API Reference > Account & User & Device [/drivers/list](https://fleetup-docs.apifox.cn/driverslist-265966530e0.md): This API returns all the drivers within this account along with the vehicle they are currently operating.
- API Reference > Account & User & Device [/devices](https://fleetup-docs.apifox.cn/devices-265966531e0.md): This API returns all device details registered with the account. Enterprise users must include a JWT token in the `Authorization` header. Use the `category` filter to fetch specific device types (e.g., vehicle, asset, temperature).
- API Reference > Account & User & Device [/devices/status](https://fleetup-docs.apifox.cn/devicesstatus-265966532e0.md): This API returns given device's status(on line/off line).
- API Reference > Account & User & Device [/devices/unlock](https://fleetup-docs.apifox.cn/devicesunlock-265966533e0.md): 
- API Reference > Account & User & Device [/devices/driver-overview](https://fleetup-docs.apifox.cn/devicesdriver-overview-265966534e0.md): This API returns the Driver’s overall details along with the current status. The API requires Account ID and Driver ID as input parameter.
- API Reference > Account & User & Device [/devices/engine-hours](https://fleetup-docs.apifox.cn/devicesengine-hours-265966535e0.md): This API will give engine hours of given devices.
- API Reference > Account & User & Device [/devices/fuel-level](https://fleetup-docs.apifox.cn/devicesfuel-level-265966536e0.md): This API will return the device’s current Fuel Level. It requires the Account ID and Device IDs as an input parameter.
- API Reference > Account & User & Device [/devices/odometer](https://fleetup-docs.apifox.cn/devicesodometer-265966537e0.md): This API will return the device’s current odometer. It requires the Account ID and Device IDs as input parameters.
- API Reference > Account & User & Device [/devices/latest-ecu-data](https://fleetup-docs.apifox.cn/deviceslatest-ecu-data-265966538e0.md): This API will give latest Fuel Level, Engine Coolant Temperature, Battery Voltage of given Devices
- API Reference > Account & User & Device [/devices/{device-id}](https://fleetup-docs.apifox.cn/devicesdevice-id-265966539e0.md): This endpoint allows users to update specific details for either vehicles or assets. Users can update the name and license for vehicles or the license and contents for assets. The request body varies depending on whether the update is for a vehicle or an asset. Only fields related to the selected type should be included. If value of a field is left empty, it will overwrite the existing data with an empty value.
- API Reference > Account & User & Device [/devices/{device-type}](https://fleetup-docs.apifox.cn/devicesdevice-type-265966540e0.md): This API is functional only for device-type = temperature OR device-type = 4CT for now. The API returns the device name and last known location details of the devices of the provided device-type that are registered with the account associated with the token. device-type path parameter in the request can be used as a filter to fetch specific category devices.Possible values that can be used for device-type are vehicle,asset,bike,temperature,4ct,dashcam,airfilter.Refer to the response model for response details.
- API Reference > Account & User & Device [/devices/{device-type}/details](https://fleetup-docs.apifox.cn/devicesdevice-typedetails-265966541e0.md): This API is functional only for device-type = temperature OR device-type = 4CT for now. This will be enhanced for other device-types in subsequent releases.This API returns maximum temperature,humidity and minimum battery levels recorded for a given deviceId for a given date range. Note that the date range should not exceed 3 days.Refer to the response model for response details.
- API Reference > Account & User & Device [/devices/{device-type}/history](https://fleetup-docs.apifox.cn/devicesdevice-typehistory-265966542e0.md): This API is functional only for device-type = temperature OR device-type = 4CT for now. This will be enhanced for other device-types in subsequent releases.This API returns temperature,humidity and battery values recorded for a given deviceId for a given date range. Note that the date range should not exceed 3 days.Refer to the response model for response details.
- API Reference > Trips [/trips/history](https://fleetup-docs.apifox.cn/tripshistory-265966543e0.md): This API will give mileage and fuel wear for trips for a given device.
- API Reference > Trips [/trips/ongoing-trips](https://fleetup-docs.apifox.cn/tripsongoing-trips-265966544e0.md): This API will give mileage and fuel wear for all on going trips.
- API Reference > Trip Share [/tripshare/live-eta](https://fleetup-docs.apifox.cn/tripsharelive-eta-265966562e0.md): This API is to share device itineraries with customers (send itinerary links to customers via email or SMS)
- API Reference > Trip Share [/tripshare/partners](https://fleetup-docs.apifox.cn/tripsharepartners-265966563e0.md): This API is to query the registered partner information under the account 
- API Reference > Trip Share [/tripshare/share](https://fleetup-docs.apifox.cn/tripshareshare-265966564e0.md): This API is to share devices with registered partners.
- API Reference > Alerts [/alerts/summary](https://fleetup-docs.apifox.cn/alertssummary-265966545e0.md): Get the summary of alerts for requested period and device ID. Summary includes the numbers of how many times alerts occurred like high speeding, high rpm, hard accelerations, hard braking, sharp turns, etc. The date range should not be more than 31 days.
- API Reference > Alerts [/alerts/history](https://fleetup-docs.apifox.cn/alertshistory-265966546e0.md): Get the history of alerts for requested period and device ID. The date range should not be more than 3 days.
- API Reference > Alerts [/alerts/bulk-history](https://fleetup-docs.apifox.cn/alertsbulk-history-265966547e0.md): Get the alert history for the specified device IDs and the requested period. The date range should not exceed 10 minutes. The devIds parameter can include up to 10 device IDs.
- API Reference > Alerts [/fencealerts/fence-names](https://fleetup-docs.apifox.cn/fencealertsfence-names-265966548e0.md): This API will return a list of all GeoFences belonging to an account. It requires Account ID as input parameter.
- API Reference > Alerts [/fencealerts/geo-fencealerts](https://fleetup-docs.apifox.cn/fencealertsgeo-fencealerts-265966549e0.md): This API will return the GeoFence Alert action type. It requires the Account ID, Device ID and Start Date and Time as an input parameter. This API will return alerts within 24 hours range starting from startDate
- API Reference > Location [Retrieve GPS data within a 24-hour time range](https://fleetup-docs.apifox.cn/retrieve-gps-data-within-a-24-hour-time-range-265966550e0.md): This API returns a list of GPS data within the specified start-time and end-time range (max 24 hours). Enterprise users must include a JWT token in the `Authorization` header.
- API Reference > Location [/gpsdata/device-last-location](https://fleetup-docs.apifox.cn/gpsdatadevice-last-location-265966551e0.md): This API will return the last known GPS coordinates of all devices under the account.
- API Reference > Location [/gpsdata/latest](https://fleetup-docs.apifox.cn/gpsdatalatest-265966552e0.md): This API will return the most recent gps data of the device.
- API Reference > Location [/gpsdata/latest/4cj](https://fleetup-docs.apifox.cn/gpsdatalatest4cj-265966553e0.md): This API will return the most recent gps data of the 4CJ/CT device for a given Account ID or Device ID. User can send either Account ID or Device ID as input to get data of all 4CJ/CT devices under an account or to get data of given 4CJ/CT device.
- API Reference > Location [/gpsdata/latest/5ta](https://fleetup-docs.apifox.cn/gpsdatalatest5ta-265966554e0.md): This API will return the most recent gps data of the 5TA device for a given Account ID or Device ID. User can send either Account ID or Device ID as input to get data of all 5TA devices under an account or to get data of given 5TA device
- API Reference > Location [/bulk-gpsdata](https://fleetup-docs.apifox.cn/bulk-gpsdata-265966555e0.md): This API returns GPS data list for multiple devices within a specified time interval. Please note that the interval of start-time and end-time should not be more than 10 minutes
- API Reference > Maintenance [/maintenance/history](https://fleetup-docs.apifox.cn/maintenancehistory-265966556e0.md): Get the historical records of maintenance done for the device requested.
- API Reference > Maintenance [/maintenance/indicators](https://fleetup-docs.apifox.cn/maintenanceindicators-265966557e0.md): Get the current values of maintenance indicators for requested device.
- API Reference > Maintenance [/maintenance/settings/indicators](https://fleetup-docs.apifox.cn/maintenancesettingsindicators-265966558e0.md): Get the details of the configured maintenance indicators, like the name, threshold and measurement type
- API Reference > Maintenance [/maintenance/settings/measurements](https://fleetup-docs.apifox.cn/maintenancesettingsmeasurements-265966559e0.md): Get the details of the maintenance measurement types like ODOMETER, ENGINE_HOUR and DAYMETER. Details include units of measurement, max/min and default threasholds, value at which warning should be handled and past due
- API Reference > Reports [/reports/temperature-sensors](https://fleetup-docs.apifox.cn/reportstemperature-sensors-265966560e0.md): This API retrieves temperature sensor data for all sensors for a specified date within the last 180 days.
- API Reference > Reports [/reports/{report-key}](https://fleetup-docs.apifox.cn/reportsreport-key-265966561e0.md): This API is to generate report data as JSON format. Note: please enable follow-redirects option when sending request.
- API Reference > Geofence [Get all fences](https://fleetup-docs.apifox.cn/get-all-fences-265966566e0.md): This API provides a complete list of geofences along with their IDs.
- API Reference > Geofence [Get fence detail](https://fleetup-docs.apifox.cn/get-fence-detail-265966567e0.md): This API provides details of a specific geofence, including its ID, name, description, radius, coordinates, and alert actions for entering and exiting.
- API Reference > Geofence [Retrieve geofence alerts](https://fleetup-docs.apifox.cn/retrieve-geofence-alerts-265966568e0.md): This API fetches geofence alerts for a specific device and geofence within the provided start and end time. If no device ID is entered, alerts for all devices under the account will be included, and if no fence ID is entered, alerts for all geofences will be considered.
- API Reference > Others [/jobs](https://fleetup-docs.apifox.cn/jobs-265966565e0.md): Create new job for applicable drivers and vehicles