HOS Log Violations (Version 3)

If called with the duration parameter, this API call is used to retrieve current drivers with HOS Log Violations and drivers at risk of going into violation for up to the duration specified. If called with the start and end parameters, this call will return all drivers who went into violation during the specified time period

Note: This is a new version of an existing API call.

Required Information
Name	Description
action	adminhos
operation	logviolations
format	xml
version	API protocol version - version 3 only
target	A driver identifier to limit the results with Note: must be used in conjunction with reqtype
reqtype	A value used to interpret the target value. Valid options are: dbid - The Zonar database id for the driver. tagid - The tagid assigned to the driver. exsid - The exsid assigned to the driver.
EITHER: duration	Number of seconds to look ahead for potential violations (Max: 3600)
OR:	start: UTC epoch, limit to 7 days of data end: UTC epoch, limit to 7 days of data

Example Request:

https://development.zonarsystems.net/gtc/interface.php?action=adminhos&operation=logviolations&version=3&format=xml&duration=3600

Violation codes:

• DR – 30 minute rest break violation
• DD – 11 hour violation
• DOD – 14 hour violation
• 7D – 60 hour violation
• 8D – 70 hour violation

Example Reply XML

<?xml version="1.0"?>
<violations>
   <entry>
        <name>John Doe</name>
        <tagid>287079</tagid>
        <exsid>GOOTOD</exsid>
        <code>8D</code>
        <start>2018-10-06 11:19:22-07</start>
        <duration>4367.73 min</duration>
        <type>In Violation</type>
        <asset>P2121</asset>
 </entry>
 ...
</violations>