44.0 Generic Data

44.1 Request Data

Back to Index

Use this to get generic data loaded into the system via the GSM interface. Parameters such as time frame, asset target and data type may be specified.

Note: Queries should be limited to no longer than 2 weeks.

Note: This function is only available in version 2.X of the API.

Required Information
Name Description
action showopen
operation gendata
format xml
version
  • 2

Note: This call is only available in version 2 or greater.

Optional Information
location Location to filter with. Text. If provided only data associated with assets assigned to this location will be returned.
start Epoch timestamp. If specified only data with a timestamp after this time will be returned. See the tstype parameter below. May be combined with end to specify a particular time period.
end Epoch timestamp. If specified only data with a timestamp before this time will be returned. See the tstype parameter below. May be combined with start to specify a particular time period.
tstype The specific timestamp to use in connection with the start and end parameters. Acceptable values:

  • data The timestamp the data was collected will be used. Note: Not all generic data has a timestamp.
  • load The timestamp the data was loaded into the system database will be used. All data will have this timestamp.
label The datatype to query for. If specified only data having that label will be returned. The label is an arbitrary text string up to 32 characters long. A list of data type currently in the system may be returned with this function
target Specific asset to report data for, rather than entire fleet. If specified then reqtype must be specified as well. See asset target for details.
reqtype Flag to identify the key being used to query. Acceptable values:

  • tag Key is a Zonar RFID tag number. In version 2 a type must also be specified.
  • exsid Key is the external system id.
  • vin Key is the Vehicle Identification Number (VIN).
  • dbid Key is the internal id number. This is the most reliable key to use.
  • fleet Key is the asset fleet number. In version 2 a type must also be specified.