Get Vehicle
Authentication
Bearer authentication of the form Bearer <token>, where token is your auth token.
Path parameters
Query parameters
Include the raw data from the telematics provider. Useful for auditing or accessing fields not normalized by Catena
Response
Immutable: The datetime the record was ingested into Catena Telematics.
Unique identifier of the connection at Catena Telematics through which this record was ingested. A connection represents a Fleet/TSP pairing.
The underlying telematics platform that provided this data (e.g., samsara, motive, hos247). Note: Some platforms like hos247 offer white-labeling, so multiple TSPs may share the same source_name — use tsp_id or tsp_slug to identify the specific ELD provider.
Unique identifier of the record in the TSP. Note: we generate a unique composite key based on available fields if the TSP does not provide an unique ID.
SHA-256 hash of the source data payload. Note: we use it internally for idempotence and deduplication.
Raw source payload as ingested from the TSP. Note: use it for audit/debugging.
Datetime of when the underlying event/observation occurred, as reported by the TSP, or the moment it was ingested by us if not available in the source data.
Unique identifier for the execution that ingested this record into Catena Telematics. Note: useful for tracing.
Unique identifier for schedule that triggered this record’s execution. Note: useful for tracing.
Additional data available in the TSP (e.g., we may have external_id, provider_resource_id, etc. — this field captures all those extra attributes in a flexible way).
Manufacturer (OEM) of the vehicle.
Manufacturer model or type designation (e.g., ‘Class 8 Tractor’, ‘Pickup’).
Model year (four-digit, e.g., 2022).
Vehicle Identification Number (VIN), typically 17 characters; if available.
Plate region/subdivision (state/province code, e.g., ‘CA’, ‘ON’).
Plate country code (ISO-3166-1 alpha-3, e.g., ‘USA’, ‘CAN’).
License plate number (e.g., ‘HMT-3570’).
Timestamp when this vehicle record became active/in service (UTC).
Timestamp when this vehicle record ended/out of service (UTC).
Indicates whether the vehicle is currently active/in service.
Operational status label (e.g., ‘IN_SERVICE’, ‘OUT_OF_SERVICE’, ‘MAINTENANCE’).
Free-text notes about the vehicle (plain text).
Telematics/ELD device identifier associated with this vehicle, if any.
Telematics/ELD device serial number, if any.
Telematics/ELD device type or model family (vendor-specific).
Telematics/ELD vendor product identifier (catalog/model code).
JSON map of group memberships/tags for this vehicle (segmentation/permissions).
Unit of measure for speed metrics (e.g., ‘km/h’, ‘mph’).
Unit of measure for odometer readings (e.g., ‘km’, ‘mi’).
Unit of measure for fuel quantities (e.g., ‘gallons’, ‘liters’).
Fuel capacity as provided by the source (text with units, e.g., ‘100 gallons’).
Engine/fuel type (e.g., ‘diesel’, ‘gasoline’, ‘electric’, ‘hybrid’).