Description

Driver status API is returning driver statuses from a DDD (tachograph) file for requested period with additional information.

Limitations

1000 req/min
Maximum period is 3 months

Request parameters

GET /driverstate/{driverId}?from_datetime=<...>&to_datetime=<...>&continuation_token=<..>&limit=<..>&version=1&api_key=<..> HTTP/1.1
Host: api.fm-track.com
Content-Type: application/json;charset=UTF-8

	Parameter	Type	Description	Is required	Remarks
1	driverId	string	External driver ID	+
2	from_datetime	date time	Find events starting from specified date	+	example for format: "2017-04-13T06:58:48.090Z" according ISO-8601
3	to_datetime	date time	Find events ending to specified date.	+	example for format: "2017-04-13T06:58:48.090Z" according ISO-8601
4	continuation_token	integer	Continuation token	-
5	limit	integer	Limits events count in response.	-	Default -100. Maximum value - 1000
6	version	string	version of API	+	At this moment we have only version=1
7	api_key	string	User identification key	+

Response parameters

{
  "continuation_token": "2022-08-29T12:05:34.770Z",
  "driver_id": "string",
  "items": [
    {
      "activity": "DRIVING",
      "duration": 0,
      "end_point": {
        "lat": 0,
        "lon": 0
      },
      "end_time": "2022-08-29T12:05:34.770Z",
      "object_id": "string",
      "plate_number": "string",
      "start_point": {
        "lat": 0,
        "lon": 0
      },
      "start_time": "2022-08-29T12:05:34.770Z"
    }
  ]
}

Name	Type	Description
continuation_token	integer	Continuation token is sent when number of events in response exceed limit
driver_id	string	External driver ID
items	array	Array of activities
activity	string	Driver state name (driving, work, rest, available, unknown)
duration	integer	Driver state duration in sec
end_point	array	Array for coordinates for state end point
lat	double	Latitude
lon	double	Longitude
end_time	date time	Driver state end time
object_id	string	External object ID (assigned to the driver)
plate_number	string	Vehicle plate number from DDD file
start_point	array	Array for coordinates for state start point
start_time	date time	Driver state start time