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
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.
One of the following time parameters
duration	Number of seconds to look ahead for potential violations (Max: 3600)
OR
start end	UTC epoch, limit to 7 days of data UTC epoch, limit to 7 days of data

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>