Skip to main content
GET
/
open-api-track
Track Vehicles
curl --request GET \
  --url https://bounpkufhwhptqbktpfl.supabase.co/functions/v1/open-api-track
{
  "code": 123,
  "record": [
    {
      "imei": "<string>",
      "longitude": 123,
      "latitude": 123,
      "gpstime": 123,
      "servertime": 123,
      "speed": 123,
      "course": 123,
      "battery": 123,
      "mileage": 123,
      "devicename": "<string>",
      "platenumber": "<string>",
      "vehicleName": "<string>"
    }
  ],
  "cached": true,
  "timestamp": 123
}
Get the latest coordinate data for tracking devices (vehicles). Returns real-time GPS tracking information for specified IMEIs.

​
Request

​
access_token
string
required
API access token from authorization endpoint
​
imeis
string
required
Comma-separated list of IMEIs (max 100)

​
Request Example

curl "https://bounpkufhwhptqbktpfl.supabase.co/functions/v1/open-api-track?access_token=example_access_token_12345&imeis=123456789012345,987654321098765"

​
Response

​
code
number
Response code (0 = success)
​
record
array
Array of tracking data objects
​
imei
string
Device IMEI number
​
longitude
number
GPS longitude coordinate
​
latitude
number
GPS latitude coordinate
​
gpstime
number
GPS timestamp (Unix timestamp in seconds)
​
servertime
number
Server timestamp (Unix timestamp in seconds)
​
hearttime
number
Heartbeat timestamp (Unix timestamp in seconds)
​
systemtime
number
System timestamp (Unix timestamp in seconds)
​
speed
number
Vehicle speed
​
course
number
Vehicle course/direction
​
acctime
number
ACC on time (seconds)
​
accstatus
number
ACC status
​
doorstatus
number
Door status
​
chargestatus
number
Charge status
​
battery
number
Battery percentage
​
mileage
number
Total mileage
​
todaymileage
number
Today’s mileage
​
externalpower
number
External power (nullable)
​
fuel
number
Fuel level (nullable)
​
fueltime
number
Fuel timestamp
​
temperature
array
Temperature array
​
temperaturetime
number
Temperature timestamp
​
oilpowerstatus
number
Oil power status
​
defencestatus
number
Defence status
​
datastatus
number
Data status
​
devicename
string
Device name
​
devicetype
string
Device type
​
platenumber
string
Vehicle plate number
​
simcard
string
SIM card number (nullable)
​
iccid
string
ICCID number (nullable)
​
imageName
string
Vehicle icon/image filename
​
vehicleName
string
Vehicle name
​
vehicleType
string
Vehicle type (nullable)
​
vehicleBrand
string
Vehicle brand
​
vehicleModel
string
Vehicle model
​
vehicleYear
number
Vehicle year
​
vehicleColor
string
Vehicle color
​
vehicleFuelType
string
Vehicle fuel type
​
vehicleOdometer
number
Vehicle odometer reading (nullable)
​
vehicleStatus
string
Vehicle status (nullable)
​
vehicleNotes
string
Vehicle notes (nullable)
​
cached
boolean
Indicates if response was from cache
​
timestamp
number
Unix timestamp

​
Success Response

{
  "code": 0,
  "record": [
    {
      "imei": "123456789012345",
      "servertime": 1609459200,
      "gpstime": 1609459100,
      "hearttime": 1609459150,
      "systemtime": 1609459050,
      "longitude": 0.0,
      "latitude": 0.0,
      "course": 0,
      "speed": 0,
      "acctime": 0,
      "accstatus": 0,
      "doorstatus": -1,
      "chargestatus": 1,
      "oilpowerstatus": 0,
      "defencestatus": 1,
      "datastatus": 2,
      "battery": 100,
      "mileage": 0,
      "todaymileage": 0,
      "externalpower": null,
      "fuel": null,
      "fueltime": 0,
      "temperature": [],
      "temperaturetime": 0,
      "devicename": "Example Device",
      "devicetype": "ExampleType",
      "platenumber": "ABC-123",
      "simcard": null,
      "iccid": null,
      "imageName": "v1.png",
      "vehicleName": "Example Vehicle",
      "vehicleType": null,
      "vehicleBrand": "ExampleBrand",
      "vehicleModel": "ExampleModel",
      "vehicleYear": 2020,
      "vehicleColor": "Blue",
      "vehicleFuelType": "Gasoline",
      "vehicleOdometer": null,
      "vehicleStatus": null,
      "vehicleNotes": null
    }
  ],
  "cached": false,
  "timestamp": 1609459200
}

​
Rate Limits

6 requests per minute per user (10s polling), 600 global requests per minute. Minimum interval: 10 seconds between requests. Cache TTL: 10 seconds (optimized for 10s polling).

​
Error Codes

Query Parameters

​
access_token
string
required

API access token from authorization endpoint

​
imeis
string
required

Comma-separated list of IMEIs (max 100)

Response

Success

​
code
integer

Response code (0 = success)

​
record
object[]
​
cached
boolean

Indicates if response was from cache

​
timestamp
integer<int64>

Unix timestamp