18.0 Get Defect Information

18.1 Request Data

Back to Index

Use this function to get information on defects. Defect information returned may be filtered on asset, repaired or unrepaired, severity of the defect and asset location.

Note: The start and end parameters were added in version 1.08 / 2.01.

Required Information
Name Description
action showopen
operation defects
format xml
Optional Information
Name Description
logvers API call version.
reqtype (logvers >= 2) The asset field used to filter asset records by. Accepted options are:

  • dbid — The Zonar database ID.
  • tagid — The Zonar RFID tag number.
  • exsid — The externally assigned system ID.
  • vin — The asset’s VIN (Vehicle Identification Number).
  • fleet — The asset fleet number.

When logvers is ‘1’, or not given, the reqtype will always be dbid.

target The value to filter asset records by.
location If specified only return defects for assets assigned to this location.

Note: If a target is specified the location is not used.

repair Defect repair status to filter on. Possible values are 'yes', 'no' and 'both'

  • 'yes' Only return defects with repairs.
  • 'no' Only return defects that have not been repaired. This is the default if repair is not specified.
  • 'both' Return both repaired and unrepaired defects.
critical Defect severity. Possible values are 'yes', 'no' and 'both'

  • 'yes' Only return critical (red) defects.
  • 'no' Only return non critical (yellow) defects.
  • 'both' Return both critical and non critical defects. This is the default if critical is not specified.
pending Defect pending repair status to filter on. Possible values are 'yes', 'no' and 'both'

  • 'yes' Only return defects with pending repairs.
  • 'no' Only return non pending defects.
  • 'both' Return both pending and non-pending defects. This is the default if pending is not specified.
start A Unix epoch time stamp. Only return defects reported later than this time. May be combined with end.
end A Unix epoch time stamp. Only return defects reported earlier than this time. May be combined with start.

Note: In future releases the date selection will be required. After that time if date ranges are used there is a 1 day limit on the date selection if no target is specified. If the a target is specified then the date limit is 365 days.

tstype A flag to indicate what the timestamp variable represents. Acceptable values are:

  • insp Timestamp is the inspection time. Defects from inspections that were performed after this time will be returned.
  • load Timestamp is the time the inspection was added to the Zonar-Web system. Defects from inspections that were uploaded after this time will be returned.
  • repair Timestamp is the time the defect was marked as repaired in the Zonar-Web system. Defects that were marked as repaired after this time will be returned.
  • pending Timestamp is the time the defect was marked as pending in the Zonar-Web system. Defects that were marked as pending after this time will be returned.

If type is not specified, or is blank a value of ‘insp‘ will be assumed.