HOS Log Violations (Version 3)

  • Last edited on

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>

ELD