FleetUp API Docs
  1. Quick Start
FleetUp API Docs
  • Quick Start
    • Your First API Call
    • Token Expiration
    • Rate Limit
    • Error Codes
  • API Reference
    • Introduction
    • Authentication
      • /token
      • Obtain JWT Token
    • Account & User & Device
      • /account-info
      • /users
      • /drivers/list
      • /devices
      • /devices/status
      • /devices/unlock
      • /devices/driver-overview
      • /devices/engine-hours
      • /devices/fuel-level
      • /devices/odometer
      • /devices/latest-ecu-data
      • /devices/{device-id}
      • /devices/{device-type}
      • /devices/{device-type}/details
      • /devices/{device-type}/history
    • Trips
      • /trips/history
      • /trips/ongoing-trips
    • Trip Share
      • /tripshare/live-eta
      • /tripshare/partners
      • /tripshare/share
    • Alerts
      • /alerts/summary
      • /alerts/history
      • /alerts/bulk-history
      • /fencealerts/fence-names
      • /fencealerts/geo-fencealerts
    • Location
      • Retrieve GPS data within a 24-hour time range
      • /gpsdata/device-last-location
      • /gpsdata/latest
      • /gpsdata/latest/4cj
      • /gpsdata/latest/5ta
      • /bulk-gpsdata
    • Maintenance
      • /maintenance/history
      • /maintenance/indicators
      • /maintenance/settings/indicators
      • /maintenance/settings/measurements
    • Reports
      • /reports/temperature-sensors
      • /reports/{report-key}
    • Geofence
      • Get all fences
      • Get fence detail
      • Retrieve geofence alerts
    • Others
      • /jobs
  • API Guides
    • Retrieve All Devices from an Enterprise
  1. Quick Start

Your First API Call

The FleetUp API uses a simple and intuitive format to manage fleet operations. By following these steps, you can quickly start using our API to access device data, GPS information, and more.

API Configuration#

PARAMVALUE
base_url *https://api.fleetup.net
acctIdObtain your Account ID from FleetUp
secretObtain your Secret Key of the account from FleetUp
x-api-keyObtain your API key from FleetUp

Generate a Token#

Step 1: Obtain a Token#

Use the POST /token endpoint to generate a JWT token. This token is valid for 3600 seconds and is required for all subsequent API calls.
Example Request:
Response:
{
  "token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9..."
}

Invoke the API#

Step 2: Use the Token to Access APIs#

For Enterprise Users:
Use the Authorization header with the JWT token for requests.
Example:
For Legacy Users (Using GET /token):
Use the token header with the legacy token.
Example:

Example Scripts#

python
nodejs

Key Notes#

Token Expiration: Tokens expire after 1 hour. Refresh them before expiration.
Enterprise Users: Only /devices and /gpsdata endpoints are supported. Use JWT tokens in the Authorization header.
Legacy Users: The GET /token endpoint is deprecated. Migrate to POST /token for continued access.
Modified at 2025-02-28 09:57:18
Next
Token Expiration
Built with