Status Operational Status

Get Operators

  • Last edited on

Returns a list of operators in the system.

This action was added in protocol version 1.02.

Request Data 

Required Information
Name Description
action showopen
operation showoperators
format xml
Optional Information
target Filter will return data for that specific operator.
reqtype Flag to identify the key being used to identify the operator. Acceptable values:
  • cdl  Comercial Drivers License Number.
  • tagid  Zonar Tag Number.
  • exsid  External System Identifier.
  • empnum  Operator's employee number.
location Location to filter with. Text. If provided only operators assigned to that location will be returned. If location is not supplied or an empty location is specified, operators from all locations will be returned.
status Operator status to filter with. Text. If provided only operators with the specified status will be returned. Possible values are:
  • active Operator is active and can load inspections.
  • revoked Operator has been revoked, is no longer active and cannot load inspections.
  • all Both
If all is specified for a status or a blank status is supplied no filtering on status is performed.
logvers
  • 1 - Standard Output Below (default)
  • 2 - Custom Data Added to XML output
  • 3 - Custom Data, PIN and CDL State data Added to XML output
  • 4 - Operators database ID number added to XML output
  • 5 - Required to return all ELD data

Data Returned

DTD

<!ELEMENT oplist (operator*)>
<!ELEMENT operator (fname, lname, cdl, tag, empnum, status, location)>
<!ELEMENT fname (#PCDATA)>
<!ELEMENT lname (#PCDATA)>
<!ELEMENT cdl (#PCDATA)>
<!ELEMENT tag (#PCDATA)>
<!ELEMENT empnum (#PCDATA)>
<!ELEMENT status (active | revoked)>
<!ELEMENT location (#PCDATA)>
<!ELEMENT exsid (#PCDATA)>
Name Description
fname Operator's first name. An arbitrary text string of up to 32 characters in length.
lname Operator's last name. An arbitrary text string of up to 32 characters in length.
cdl Operator's Commercial Drivers License number.
tag Zonar Systems™ RFID tag number of the operator. A non zero 32 bit integer quantity.
empnum Operator's employee number.
status Operator status either active or revoked. Revoked operators may not load inspections.
location The location that the operator is assigned to.
exsid Operator External System Identifier. An arbitrary text string of up to 40 characters in length. Used to provide compatibility with external systems. This must be unique per operator.

In addition to the attributes that are already exposed for an operator via the existing Get Operators API call, the following have to be added to the output variables for logvers 5:

Name Description
email Driver’s email address
location_timezone Drivers Home terminal timezone (PST8PDT)

Example Request

https://omi.zonarsystems.net/interface.php?customer=zzo2544&username=zonar&password=secret.pw.2019&action=showopen&operation=showoperators&format=xml

Example Request (log version 5)

https://omi.zonarsystems.net/interface.php?customer=zzo2544&username=zonar&password=secret.pw.2019&action=showopen&operation=showoperators&format=xml&logvers=5

 Example Success Reply

<?xml version="1.0"?>
<oplist ver="1.17">
 <operator>
 <fname>Jesse</fname>
 <lname>Young</lname>
 <tag>2021</tag>
 <cdl>CADL486245</cdl>
 <empnum>2021</empnum>
 <status>active</status>
 <location>Home</location>
 <exsid>2021</exsid>
 </operator>
 <operator>
 <fname>David</fname>
 <lname>Wolford</lname>
 <tag>2606</tag>
 <cdl>AK88769532</cdl>
 <empnum>1987</empnum>
 <status>active</status>
 <location>Home</location>
 <exsid></exsid>
 </operator>
 <operator>
 <fname>Jeff</fname>
 <lname>Wells</lname>
 <tag>4505</tag>
 <cdl>AZ55101255</cdl>
 <empnum>4505</empnum>
 <status>active</status>
 <location>Home</location>
 <exsid></exsid>
 </operator>
 <operator>
 <fname>Bob</fname>
 <lname>Watkins</lname>
 <tag>1565</tag>
 <cdl>NY15873U67</cdl>
 <empnum>9085</empnum>
 <status>active</status>
 <location>Home</location>
 <exsid></exsid>
 </operator>
 <operator>
 <fname>Chancy</fname>
 <lname>Tribi</lname>
 <tag>2022</tag>
 <cdl>WA5564J96</cdl>
 <empnum>2022</empnum>
 <status>active</status>
 <location>Home</location>
 <exsid></exsid>
 </operator>
 <operator>
 <fname>Dave</fname>
 <lname>Thomas</lname>
 <tag>1012</tag>
 <cdl>FL420UIN54</cdl>
 <empnum>9685</empnum>
 <status>active</status>
 <location>Home</location>
 <exsid></exsid>
 </operator>
 <operator>
 <fname>Andy</fname>
 <lname>Strong</lname>
 <tag>1500</tag>
 <cdl>MN9524263</cdl>
 <empnum>6398</empnum>
 <status>active</status>
 <location>Home</location>
 <exsid></exsid>
 </operator>
 <operator>
 <fname>KYLE J.</fname>
 <lname>SPARKS</lname>
 <tag>1978</tag>
 <cdl>BA544F0032</cdl>
 <empnum>1078</empnum>
 <status>active</status>
 <location>Zonar Chelan</location>
 <exsid></exsid>
 </operator>
 <operator>
 <fname>Jay</fname>
 <lname>Smith</lname>
 <tag>2020</tag>
 <cdl>NJ336G2020</cdl>
 <empnum>2020</empnum>
 <status>active</status>
 <location>Home</location>
 <exsid></exsid>
 </operator>
 <operator>
 <fname>Dave</fname>
 <lname>Smith</lname>
 <tag>1172</tag>
 <cdl>DS343940FG</cdl>
 <empnum>2134</empnum>
 <status>active</status>
 <location>Home</location>
 <exsid></exsid>
 </operator>
 <operator>
 <fname>Jorge</fname>
 <lname>Smith</lname>
 <tag>2024</tag>
 <cdl>1245LDOERJ</cdl>
 <empnum>2024</empnum>
 <status>active</status>
 <location>Home</location>
 <exsid></exsid>
 </operator>
 <operator>
 <fname>Greg</fname>
 <lname>Silus</lname>
 <tag>1501</tag>
 <cdl>MN4545DR5</cdl>
 <empnum>1988</empnum>
 <status>active</status>
 <location>Home</location>
 <exsid></exsid>
 </operator>
 <operator>
 <fname>Dave</fname>
 <lname>Schaible</lname>
 <tag>1002</tag>
 <cdl>COL1002CD</cdl>
 <empnum>1039</empnum>
 <status>active</status>
 <location>Home</location>
 <exsid></exsid>
 </operator>
 <operator>
 <fname>Kelly</fname>
 <lname>Niemi</lname>
 <tag>1003</tag>
 <cdl>WDLMOU82</cdl>
 <empnum>4254</empnum>
 <status>active</status>
 <location>Home</location>
 <exsid></exsid>
 </operator>
 <operator>
 <fname>Fred</fname>
 <lname>Miller</lname>
 <tag>2584</tag>
 <cdl>WA87M4367</cdl>
 <empnum>2584</empnum>
 <status>active</status>
 <location>Home</location>
 <exsid></exsid>
 </operator>
 <operator>
 <fname>Jack</fname>
 <lname>McQuade</lname>
 <tag>1970</tag>
 <cdl>WADL19199</cdl>
 <empnum>1970</empnum>
 <status>active</status>
 <location>Home</location>
 <exsid></exsid>
 </operator>
 <operator>
 <fname>Mike</fname>
 <lname>McQuade</lname>
 <tag>5285</tag>
 <cdl>WADL43343</cdl>
 <empnum>0052</empnum>
 <status>active</status>
 <location>Home</location>
 <exsid></exsid>
 </operator>
 <operator>
 <fname>Dan</fname>
 <lname>Mayer</lname>
 <tag>1979</tag>
 <cdl>WADL89889</cdl>
 <empnum>1979</empnum>
 <status>active</status>
 <location>Home</location>
 <exsid></exsid>
 </operator>
 <operator>
 <fname>Eric</fname>
 <lname>Manegold</lname>
 <tag>2636</tag>
 <cdl>WADL21212</cdl>
 <empnum>0026</empnum>
 <status>active</status>
 <location>Home</location>
 <exsid></exsid>
 </operator>
 <operator>
 <fname>Jason</fname>
 <lname>Line</lname>
 <tag>1910</tag>
 <cdl>WADL26522</cdl>
 <empnum>1909</empnum>
 <status>active</status>
 <location>Home</location>
 <exsid></exsid>
 </operator>
 <operator>
 <fname>Tony</fname>
 <lname>Leuenberger</lname>
 <tag>6010</tag>
 <cdl>LEUE223092</cdl>
 <empnum>1111</empnum>
 <status>active</status>
 <location>seattle</location>
 <exsid></exsid>
 </operator>
 <operator>
 <fname>Karrel</fname>
 <lname>Koroush</lname>
 <tag>1656</tag>
 <cdl>OR9844TG5</cdl>
 <empnum>0074</empnum>
 <status>active</status>
 <location>Home</location>
 <exsid></exsid>
 </operator>
 <operator>
 <fname>Dustin</fname>
 <lname>Koons</lname>
 <tag>1171</tag>
 <cdl>WADL64331</cdl>
 <empnum>1171</empnum>
 <status>active</status>
 <location>Home</location>
 <exsid></exsid>
 </operator>
 <operator>
 <fname>Nels</fname>
 <lname>Johnson</lname>
 <tag>1125</tag>
 <cdl>NJ667548A2</cdl>
 <empnum>1756</empnum>
 <status>active</status>
 <location>Home</location>
 <exsid></exsid>
 </operator>
 <operator>
 <fname>Wade</fname>
 <lname>Johnson</lname>
 <tag>1250</tag>
 <cdl>RI456Y8910</cdl>
 <empnum>1298</empnum>
 <status>active</status>
 <location>seattle</location>
 <exsid></exsid>
 </operator>
 <operator>
 <fname>Colin</fname>
 <lname>Ivory</lname>
 <tag>1953</tag>
 <cdl>IV34329803</cdl>
 <empnum>5187</empnum>
 <status>active</status>
 <location>Zonar Australia</location>
 <exsid></exsid>
 </operator>
 <operator>
 <fname>Leeanne</fname>
 <lname>Ivory</lname>
 <tag>8698</tag>
 <cdl>LI76588763</cdl>
 <empnum>0002</empnum>
 <status>active</status>
 <location>Zonar Australia</location>
 <exsid></exsid>
 </operator>
 <operator>
 <fname>Darrin</fname>
 <lname>Huston</lname>
 <tag>1587</tag>
 <cdl>DH9877RZ3</cdl>
 <empnum>1865</empnum>
 <status>active</status>
 <location>Home</location>
 <exsid></exsid>
 </operator>
 <operator>
 <fname>Tommy</fname>
 <lname>Holst</lname>
 <tag>1903</tag>
 <cdl>WA2807203</cdl>
 <empnum>1903</empnum>
 <status>active</status>
 <location>Home</location>
 <exsid></exsid>
 </operator>
 <operator>
 <fname>Christopher</fname>
 <lname>Haigh</lname>
 <tag>3221</tag>
 <cdl>AK28047203</cdl>
 <empnum>3221</empnum>
 <status>active</status>
 <location>Zonar Australia</location>
 <exsid></exsid>
 </operator>
 <operator>
 <fname>Marti</fname>
 <lname>Gardner</lname>
 <tag>10058</tag>
 <cdl>VA932289</cdl>
 <empnum>10058</empnum>
 <status>revoked</status>
 <location>Home</location>
 <exsid></exsid>
 </operator>
 <operator>
 <fname>Marti</fname>
 <lname>Gardner</lname>
 <tag>2425</tag>
 <cdl>MG2324456</cdl>
 <empnum>1236</empnum>
 <status>active</status>
 <location>Home</location>
 <exsid></exsid>
 </operator>
 <operator>
 <fname>April</fname>
 <lname>Force</lname>
 <tag>1888</tag>
 <cdl>AZ00000066</cdl>
 <empnum>1906</empnum>
 <status>active</status>
 <location>Home</location>
 <exsid></exsid>
 </operator>
 <operator>
 <fname>bar</fname>
 <lname>Foo</lname>
 <tag>2112</tag>
 <cdl></cdl>
 <empnum></empnum>
 <status>active</status>
 <location>Home</location>
 <exsid></exsid>
 </operator>
 <operator>
 <fname>Dan</fname>
 <lname>Fehrenbacher</lname>
 <tag>3635</tag>
 <cdl>PC37629HA</cdl>
 <empnum>1220</empnum>
 <status>active</status>
 <location>Home</location>
 <exsid></exsid>
 </operator>
 <operator>
 <fname>George</fname>
 <lname>Edgerton</lname>
 <tag>2157</tag>
 <cdl>CADL757575</cdl>
 <empnum>0021</empnum>
 <status>active</status>
 <location>Home</location>
 <exsid></exsid>
 </operator>
 <operator>
 <fname>Zonar</fname>
 <lname>Driver</lname>
 <tag>1015</tag>
 <cdl>WADL56561</cdl>
 <empnum>1085</empnum>
 <status>active</status>
 <location>Home</location>
 <exsid></exsid>
 </operator>
 <operator>
 <fname>John</fname>
 <lname>Doherty</lname>
 <tag>5333</tag>
 <cdl>WADL56556</cdl>
 <empnum>0005</empnum>
 <status>active</status>
 <location>Home</location>
 <exsid></exsid>
 </operator>
 <operator>
 <fname>Aaron</fname>
 <lname>Denton</lname>
 <tag>2323</tag>
 <cdl>CDL1979851</cdl>
 <empnum>2323</empnum>
 <status>active</status>
 <location>Home</location>
 <exsid></exsid>
 </operator>
 <operator>
 <fname>jimmy</fname>
 <lname>Crittenden</lname>
 <tag>70070</tag>
 <cdl>CO700707</cdl>
 <empnum>00707</empnum>
 <status>revoked</status>
 <location>Home</location>
 <exsid></exsid>
 </operator>
 <operator>
 <fname>Kim</fname>
 <lname>Connaker</lname>
 <tag>2534</tag>
 <cdl>IDDL1919412</cdl>
 <empnum>2548</empnum>
 <status>active</status>
 <location>Home</location>
 <exsid></exsid>
 </operator>
 <operator>
 <fname>Mike</fname>
 <lname>Connaker</lname>
 <tag>34</tag>
 <cdl>WA87455426</cdl>
 <empnum>0040</empnum>
 <status>active</status>
 <location>Home</location>
 <exsid></exsid>
 </operator>
 <operator>
 <fname>Bill Sr.</fname>
 <lname>Brinton</lname>
 <tag>1941</tag>
 <cdl>CADL626262</cdl>
 <empnum>1941</empnum>
 <status>active</status>
 <location>Home</location>
 <exsid></exsid>
 </operator>
 <operator>
 <fname>Brett</fname>
 <lname>Brinton</lname>
 <tag>7487</tag>
 <cdl>CADL36NB86</cdl>
 <empnum>0077</empnum>
 <status>active</status>
 <location>Home</location>
 <exsid></exsid>
 </operator>
 <operator>
 <fname>Bill</fname>
 <lname>Brinton</lname>
 <tag>2578</tag>
 <cdl>CADL545455</cdl>
 <empnum>0123</empnum>
 <status>active</status>
 <location>Home</location>
 <exsid></exsid>
 </operator>
 <operator>
 <fname>Tom</fname>
 <lname>Bentzen</lname>
 <tag>4565</tag>
 <cdl>WADL6978KI</cdl>
 <empnum>1964</empnum>
 <status>active</status>
 <location>Home</location>
 <exsid></exsid>
 </operator>
 <operator>
 <fname>Noel</fname>
 <lname>Bell</lname>
 <tag>1069</tag>
 <cdl></cdl>
 <empnum>1069</empnum>
 <status>active</status>
 <location>Home</location>
 <exsid></exsid>
 </operator>
 <operator>
 <fname>Greg</fname>
 <lname>Anderson</lname>
 <tag>1909</tag>
 <cdl>WADL22322</cdl>
 <empnum>0019</empnum>
 <status>active</status>
 <location>Home</location>
 <exsid></exsid>
 </operator>
 <operator>
 <fname>MiKe</fname>
 <lname>AKRE</lname>
 <tag>6997</tag>
 <cdl>DEW8794H56</cdl>
 <empnum>6667</empnum>
 <status>active</status>
 <location>Home</location>
 <exsid></exsid>
 </operator>
</oplist>

Example Request - Single Target

https://omi.zonarsystems.net/interface.php?customer=zzo2544&username=zonar&password=secret.pw.2019&action=showopen&operation=showoperators&format=xml&target=2021&reqtype=exsid

Example Success Reply

<?xml version="1.0"?>
<oplist ver="1.17">
 <operator>
 <fname>Jesse</fname>
 <lname>Young</lname>
 <tag>2021</tag>
 <cdl>CADL486245</cdl>
 <empnum>2021</empnum>
 <status>active</status>
 <location>Home</location>
 <exsid>2021</exsid>
 </operator>
</oplist>

Example Success Reply (log version 5)

<?xml version="1.0"?>
<oplist ver="1.19">
 <operator>
 <fname>Bob</fname>
 <lname>Brown</lname>
 <id>2924</id>
 <email>test@test.com</email>
 <location_timezone>PST8PDT</location_timezone>
 <tag>4411</tag>
 <cdl>DGMALCDL</cdl>
 <empnum>131363</empnum>
 <status>active</status>
 <location>Home</location>
 <exsid>131363</exsid>
 <pin>4411</pin>
 <cdlstate>WA</cdlstate>
 <customdata />
 </operator>
 ...
</oplist>
 

Driver Management