Status Operational Status

HOS Log Violations (Version 3)

  • Last edited on

This API call returns all HOS violations meeting the specified parameters. 

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
Only HOS violations beginning after this timestamp will be included.
end UTC epoch, limit to 7 days of data
Only HOS violations beginning before this timestamp will be included.
Optional Information
target If included, restricts violations to the specified driver.

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 Request:

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