×
 

Object history

This API returns the movement history of a vehicle for a specified period. It provides tracks with information about mileage, operating time, stops, start and end coordinates, and more.

How to get data

Method

POST

Request address

To get the data, use the address: https://<server_address>/api/CRIT/api.php?node=<node_id>

Request parameters

To retrieve the data, you must send an authorized request and specify the function and parameters:
  • Username — user login
  • Password — user password
  • functionName=api_objecthistory — command to get the object history
  • parameters — a parameter string in the following format:
    IMEI,FROM_DATETIME,TO_DATETIME
    where:
  • IMEI — object IMEI
  • FROM_DATETIME — start date and time of the period
  • TO_DATETIME — end date and time of the period
Response format: an array of object tracks for the specified period.
 

Example request

POST https://<server_address>/api/CRIT/api.php?node=6
Content-Type: multipart/form-data
 
Username=TestName
Password= 123456
functionName=api_objecthistory
parameters=352016704092097,2025-11-21 04:07:03,2025-11-23 04:07:03
Response
[
 {
 "FLCNSMD": 0,
 "ENDTM": "2025-11-21 19:05:30",
 "MILEGND": 106286.11,
 "ENDLCTN": "Sakaka, Al Jawf Region, 3628, Saudi Arabia",
 "IDLDRTN": "00:00:00",
 "CNT": 1,
 "WRKNGDRTN": "07:47:22",
 "MILEGN": 826.37,
 "DRVR": "",
 "startlatitude": 24.399892,
 "OBJTID": 1344487,
 "WRKNGSTRTTM": "2025-11-21 11:18:08",
 "endlongitude": 48.20568,
 "startlongitude": 39.644265,
 "STPDRTN": "00:12:28",
 "DY": "2025-11-21",
 "endlatitude": 29.960238,
 "OBJCTNME": "5209 ب د م",
 "WRKNGSTRTLCTN": "Sakaka, Al Jawf Region, 3628, Saudi Arabia",
 "MXSPDP": 136
 }
]
The API response returns an array of tracks for the specified period. Each track object contains the following fields:
  • FLCNSMD — fuel consumption within this track
  • ENDTM — track end time
  • MILEGND — total mileage at the end of the track
  • ENDLCTN — address of the track end point
  • IDLDRTN — total idle time within this track
  • CNT — track sequence number (index) for the day
  • WRKNGDRTN — total engine operating time / ignition ON time
  • MILEGN — mileage covered within this track
  • DRVR — driver name
  • startlatitude — latitude of the track start point
  • startlongitude — longitude of the track start point
  • endlatitude — latitude of the track end point
  • endlongitude — longitude of the track end point
  • OBJTID — internal object identifier
  • WRKNGSTRTTM — time of the first ignition ON within this track
  • STPDRTN — total stop duration within the track
  • DY — track date
  • OBJCTNME — object name
  • WRKNGSTRTLCTN — address of the track start point
  • MXSPDP — maximum speed reached in this track