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.

Required Information
Name	Description
action	adminhos
operation	logviolations
format	xml
version	API protocol version - version 3 only
start	UTC epoch, limit to 7 days of data
end	UTC epoch, limit to 7 days of data
Optional Information
target	A driver identifier to limit the results with 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.

Example Requests:

Using duration:

https://omi.zonarsystems.net/interface.php?customer=zzo2544&username=zonar&password=secret.pw.2019&action=adminhos&operation=logviolations&version=3&format=xml&duration=3600

Using start and end:

https://omi.zonarsystems.net/interface.php?customer=zzo2544&username=zonar&password=secret.pw.2019&action=adminhos&operation=logviolations&version=3&format=xml&&start=1556170925&end=1556318551

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>