Snapshot - Fleet

Endpoint Description

The fleet snapshot endpoint uses the common schema to provide a snapshot view of a fleet. A snapshot is a single point in time. Time-series data, such as fault codes and switch status, are not included in the snapshot view. This endpoint is paginated with a default of 100 records per page.

Request Information

URI

Authorize GEThttps://api20.takeuchi-us.com/Telematics/v3/Fleet/{pageNumber}

URI Parameters

Name Description Type Additional Information
pageNumber Navigation is controlled by the page number parameter. string Required

Header Parameters

Key Value Description Requirements
Authorization Bearer *Token generated from Connect endpoints. Authorization is required to access this endpoint. Required
Accept */* | application/xml | application/json By default responses will be "application/xml". Optional

Body Parameters

None (Empty)

Response Information

Resource Description

Response will be defined by ISO/TS, and can either be XML or JSON format.

Fleet

Name Description Type Additional Information
Links Links are used to describe the meta data about call. Each link contains a relationship (rel) and a hyperlink (href). Collection of FleetLinks Single-Element snapshot may not contain links.
Equipment Equipment(s) are earth-moving machinery, which can be identified by the PIN or VIN in the equipment header. Contains data points related to the equipment(s). Collection of FleetEquipment Single-Element snapshots will contain a single element.
version Declaration Version specifies the version of the XML standard to which the XML document conforms. string
snapshotTime The snapshot time is the date and time at which the snapshot of the fleet was created. string Date and Time are expressed as: YYYY-MM-DDThh:mm:ssZ

Response Formats

<Fleet xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" version="sample string 1" xmlns="http://www.jcmanet.or.jp/english2017/ISO/15143/-3/20190501">
  <Links>
    <rel>sample string 1</rel>
    <href>sample string 2</href>
  </Links>
  <Links>
    <rel>sample string 1</rel>
    <href>sample string 2</href>
  </Links>
  <Equipment>
    <EquipmentHeader>
      <UnitInstallDateTime>0001-01-01T00:00:00Z</UnitInstallDateTime>
      <OEMName>sample string 2</OEMName>
      <Model>sample string 3</Model>
      <EquipmentID>sample string 4</EquipmentID>
      <SerialNumber>sample string 5</SerialNumber>
      <PIN>sample string 6</PIN>
    </EquipmentHeader>
    <Location datetime="0001-01-01T00:00:00Z">
      <Latitude>1</Latitude>
      <Longitude>2</Longitude>
      <Altitude>3</Altitude>
      <AltitudeUnits>sample string 4</AltitudeUnits>
    </Location>
    <CumulativeOperatingHours>
      <Hour>1</Hour>
      <datetime>0001-01-01T00:00:00Z</datetime>
    </CumulativeOperatingHours>
    <DEFRemaining datetime="0001-01-01T00:00:00Z">
      <Percent>1</Percent>
      <DEFTankCapacityUnits>sample string 2</DEFTankCapacityUnits>
      <DEFTankCapacity>3</DEFTankCapacity>
    </DEFRemaining>
    <EngineStatus datetime="0001-01-01T00:00:00Z">
      <EngineNumber>sample string 1</EngineNumber>
      <Running>true</Running>
    </EngineStatus>
    <FuelUsed datetime="0001-01-01T00:00:00Z">
      <FuelUnits>sample string 1</FuelUnits>
      <FuelConsumed>2</FuelConsumed>
    </FuelUsed>
    <FuelRemaining datetime="0001-01-01T00:00:00Z">
      <Percent>1</Percent>
      <FuelTankCapacityUnits>sample string 2</FuelTankCapacityUnits>
      <FuelTankCapacity>3</FuelTankCapacity>
    </FuelRemaining>
  </Equipment>
  <Equipment>
    <EquipmentHeader>
      <UnitInstallDateTime>0001-01-01T00:00:00Z</UnitInstallDateTime>
      <OEMName>sample string 2</OEMName>
      <Model>sample string 3</Model>
      <EquipmentID>sample string 4</EquipmentID>
      <SerialNumber>sample string 5</SerialNumber>
      <PIN>sample string 6</PIN>
    </EquipmentHeader>
    <Location datetime="0001-01-01T00:00:00Z">
      <Latitude>1</Latitude>
      <Longitude>2</Longitude>
      <Altitude>3</Altitude>
      <AltitudeUnits>sample string 4</AltitudeUnits>
    </Location>
    <CumulativeOperatingHours>
      <Hour>1</Hour>
      <datetime>0001-01-01T00:00:00Z</datetime>
    </CumulativeOperatingHours>
    <DEFRemaining datetime="0001-01-01T00:00:00Z">
      <Percent>1</Percent>
      <DEFTankCapacityUnits>sample string 2</DEFTankCapacityUnits>
      <DEFTankCapacity>3</DEFTankCapacity>
    </DEFRemaining>
    <EngineStatus datetime="0001-01-01T00:00:00Z">
      <EngineNumber>sample string 1</EngineNumber>
      <Running>true</Running>
    </EngineStatus>
    <FuelUsed datetime="0001-01-01T00:00:00Z">
      <FuelUnits>sample string 1</FuelUnits>
      <FuelConsumed>2</FuelConsumed>
    </FuelUsed>
    <FuelRemaining datetime="0001-01-01T00:00:00Z">
      <Percent>1</Percent>
      <FuelTankCapacityUnits>sample string 2</FuelTankCapacityUnits>
      <FuelTankCapacity>3</FuelTankCapacity>
    </FuelRemaining>
  </Equipment>
</Fleet>
Return