get https://api.gomotive.com/v1/oem_entities
Purpose: Use this API to fetch a list of all the associated OEM entities such as assets or other machinery. These entities help fleet managers keep track of their equipment and assets by providing comprehensive details about each item. This information aids in efficient management, maintenance scheduling, operational monitoring, and ensuring compliance with various operational standards.
require 'uri'
require 'net/http'
url = URI('https://api.gomotive.com/v1/oem_entities')
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request['Authorization'] = "Bearer <OAUTH_TOKEN>"
response = http.request(request)
puts response.read_body
Response Parameters
oem_entities
- Type: Array of Objects
- Description: List of OEM (Original Equipment Manufacturer) entities associated with the system.
.id
- Type: Integer
- Description: Unique identifier for the OEM entity.
updated_at
- Type: String (Date-Time)
- Description: Timestamp when the OEM entity was last updated.
status
- Type: String
- Description: Status of the OEM entity (e.g., "active").
entity_type
- Type: String
- Description: Type of the entity (e.g., "asset").
make
- Type: String
- Description: Manufacturer of the asset (e.g., "KOMATSU").
model
- Type: String
- Description: Model of the asset (e.g., "PC138USLC-11").
type
- Type: String
- Description: General type of the entity (e.g., "other").
custom_type
- Type: String
- Description: Custom type identifier for the entity.
serial_number
- Type: String
- Description: Serial number of the asset.
vendor
- Type: String
- Description: Vendor or supplier of the asset (e.g., "Komtrax (Komatsu)").
locations
- Type: Array of Objects
- Description: List of location details for the asset.
updated_at
- Type: String (Date-Time)
- Description: Timestamp when the location data was last updated.
zip
- Type: String
- Description: ZIP code of the asset's location.
country
- Type: String
- Description: Country where the asset is located (e.g., "US").
state
- Type: String
- Description: State where the asset is located (e.g., "LA").
city
- Type: String
- Description: City where the asset is located (e.g., "Houma").
street
- Type: String
- Description: Street address where the asset is located (e.g., "S Van Ave").
house_number
- Type: String
- Description: House number on the street address.
lat
- Type: Float
- Description: Latitude coordinate of the asset's location.
lon
- Type: Float
- Description: Longitude coordinate of the asset's location.
operating_hours
- Type: Float
- Description: Total operating hours recorded for the asset.
idle_hours
- Type: Float
- Description: Total idle hours recorded for the asset.
fuel_used
- Type: Integer
- Description: Amount of fuel used by the asset.
fuel_used_last_day
- Type: Integer
- Description: Amount of fuel used in the last day.
fuel_units
- Type: String
- Description: Units of fuel measurement (e.g., "litre").
fuel_remaining
- Type: Integer
- Description: Amount of fuel remaining.
def_remaining
- Type: Integer
- Description: Amount of DEF (Diesel Exhaust Fluid) remaining.
engine_number
- Type: String
- Description: Engine number of the OEM equipment.
engine_running
- Type: Boolean
- Description: Indicates if the engine is running (e.g., false).
power_take_off_hours
- Type: String
- Description: Total power take-off hours recorded for the asset.
avg_load_factor_last_day
- Type: String
- Description: Average load factor for the last day.
max_speed_last_day
- Type: String
- Description: Maximum speed recorded in the last day.
max_speed_unit
- Type: String
- Description: Unit of measurement for maximum speed.
load_count
- Type: Integer
- Description: Count of loads recorded.
payload_totals
- Type: Integer
- Description: Total payload recorded.
payload_units
- Type: String
- Description: Units of measurement for payload.
non_productive_regen_hours
- Type: String
- Description: Hours spent in non-productive regeneration.
idle_non_operating_hours
- Type: String
- Description: Hours spent idle and not operating.