Skip to main content
GET
/
v2
/
telematics
/
trailers
/
{trailer_id}
Get Trailer
curl --request GET \
  --url https://api.catenatelematics.com/v2/telematics/trailers/{trailer_id} \
  --header 'Authorization: Bearer <token>'
{
  "fleet_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z",
  "connection_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "source_id": "<string>",
  "source_data_hash": "<string>",
  "fleet_ref": "<string>",
  "deleted_at": "2023-11-07T05:31:56Z",
  "tsp_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "tsp_slug": "<string>",
  "source_data": {},
  "occurred_at": "2023-11-07T05:31:56Z",
  "execution_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "schedule_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "extras": {},
  "trailer_name": "<string>",
  "oem": "<string>",
  "model_type": "<string>",
  "model_year": 123,
  "vin": "<string>",
  "license_plate_region": "<string>",
  "license_plate_country": "<string>",
  "license_plate_number": "<string>",
  "started_at": "2023-11-07T05:31:56Z",
  "ended_at": "2023-11-07T05:31:56Z",
  "is_active": true,
  "status": "<string>",
  "notes": "<string>",
  "eld_id": "<string>",
  "eld_serial_number": "<string>",
  "eld_device_type": "<string>",
  "eld_product_id": "<string>",
  "total_axles": 123,
  "trailer_groups": {},
  "external_id": "<string>",
  "trailer_length": 123,
  "trailer_type": "<string>",
  "speed_unit": "<string>",
  "odometer_unit": "<string>",
  "fuel_unit": "<string>",
  "fuel_capacity": "<string>",
  "engine_type": "<string>"
}

Authorizations

Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Path Parameters

trailer_id
string<uuid>
required

The unique identifier of the trailer.

Query Parameters

include_source_data
boolean
default:false

Include the raw data from the telematics provider. Useful for auditing or accessing fields not normalized by Catena

Response

Successful Response

Trailer model for API responses

fleet_id
string<uuid> | null
required

Internal fleet identifier.

id
string<uuid>
required

Unique identifier of the record at Catena Telematics.

created_at
string<date-time>
required

Immutable: The datetime the record was ingested into Catena Telematics.

updated_at
string<date-time>
required

The dateime the record was last modified in Catena Telematics.

connection_id
string<uuid>
required

Unique identifier of the connection at Catena Telematics through which this record was ingested. A connection represents a Fleet/TSP pairing.

source_name
enum<string>
required

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.

Available options:
ada,
ai_eld,
air_eld,
alfa_eld,
alpha_eld,
als,
anytrek_pro,
anytrek_classic,
apex_eld,
apollo,
apollocloud,
ascend,
att,
awaregps,
azuga,
bigroad,
bluehorse_eld,
blueinktech,
bouncie,
budgetgps,
catena_simulator,
captain_eld,
carrier_lynx,
club_eld,
counting_trucks_eld,
cyntrx,
digital_eld,
dragon_eld,
drive_hos,
drive_hos_v2,
driver_tech,
dsg_elogs,
dynamic_eld,
eighteighteight_eld,
eld_88,
eld_books,
eld_mandate,
eld_mandate_prime,
eroad,
eva_eld,
evo_eld,
expressway_eld,
extreme_eld,
ezlogz,
ez_lynk,
factor_eld,
firstgate,
fleetcomplete,
fleetcompletehub,
fleethunt,
fleetpulse,
fleetsharp,
fleetup,
fm,
forwardthinking,
forza_eld,
geotab,
gpsinsight,
gpstab,
gpstrackit,
grand_eld,
greenlight,
groundhog,
hcss,
hos247,
hutch,
intellishift,
ironman_eld,
isaac,
jjkeller,
kinexaiot,
knight_eld,
konexial,
lioneight,
linxup,
loop_eld,
lucid_eld,
luna_eld,
lytx,
lytxv3,
mapon,
matrack,
maven,
mdm_eld,
mobilefleet,
moonlight_eld,
motion_eld,
motive,
my_drivebook,
my_logs_eld,
nero,
netradyne,
new_eld_world,
nextgen_eld,
nextraq,
omnitracs,
onestep,
ontime_eld,
optima,
orbcomm,
orient_eld,
panda_eld,
payd,
peak_eld,
peoplenet,
phillips_connect,
phoenix,
pop_eld,
prologs,
proride_eld,
qualitylogs_eld,
randmcnally,
rastrac,
raven,
redfox,
regulog_eld,
ridehub,
roadeazy,
rock_eld,
rollingtrans,
routemate,
royal_eld,
safelane,
samsara,
selectivedrive,
simba_eld,
skybitz,
smart_elds,
sparkle_eld,
spireon,
sun_eld,
surfsight,
swift,
switchboard,
synergy_eld,
teletracnavman,
teletracnavman_director,
telogis,
tenna,
thermo_king,
think,
tive,
topcompliance_eld,
traccar,
trackease_eld,
trackpro,
traclog,
transflo,
trimble,
truckford,
truckspy,
truckx,
trueroad_eld,
tt,
txt_eld,
us_fast_eld,
verizon_connect,
vista_eld,
vistracks,
vlog_eld,
vulcansols_eld,
wialon,
webfleet,
xplore_eld,
zigzag_eld,
zms_eld,
zonar,
zubie
source_id
string
required

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.

source_data_hash
string
required

SHA-256 hash of the source data payload. Note: we use it internally for idempotence and deduplication.

Maximum string length: 64
fleet_ref
string | null

External fleet reference in the partner system.

deleted_at
string<date-time> | null

The datetime the record was logically deleted from Catena Telematics.

tsp_id
string<uuid> | null

Unique identifier of the TSP at Catena Telematics from which this record was ingested.

tsp_slug
string | null

Human readable slug of the TSP at Catena Telematics from which this record was ingested.

source_data
Source Data · object

Raw source payload as ingested from the TSP. Note: use it for audit/debugging.

occurred_at
string<date-time> | null

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.

execution_id
string<uuid> | null

Unique identifier for the execution that ingested this record into Catena Telematics. Note: useful for tracing.

schedule_id
string<uuid> | null

Unique identifier for schedule that triggered this record's execution. Note: useful for tracing.

extras
Extras · object

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).

trailer_name
string | null

Display name or unit number for the trailer.

oem
string | null

Manufacturer (OEM) of the trailer.

model_type
string | null

Manufacturer model or type designation (e.g., '53ft Dry Van', 'Reefer').

model_year
integer | null

Model year (four-digit, e.g., 2022).

vin
string | null

Vehicle Identification Number (VIN), typically 17 characters; if available.

license_plate_region
string | null

Plate region/subdivision (state/province code, e.g., 'CA', 'ON').

license_plate_country
string | null

Plate country code (ISO-3166-1 alpha-2, e.g., 'US', 'CA').

license_plate_number
string | null

License plate number (e.g., 'HMT-3570').

started_at
string<date-time> | null

Timestamp when this trailer record became active/in service (UTC).

ended_at
string<date-time> | null

Timestamp when this trailer record ended/out of service (UTC).

is_active
boolean | null

Indicates whether this trailer is currently active/in service.

status
string | null

Operational status label (e.g., 'IN_SERVICE', 'OUT_OF_SERVICE', 'MAINTENANCE').

notes
string | null

Free-text notes about the trailer (plain text).

eld_id
string | null

Telematics/ELD device identifier associated with this trailer, if any.

eld_serial_number
string | null

Telematics/ELD device serial number, if any.

eld_device_type
string | null

Telematics/ELD device type or model family (vendor-specific).

eld_product_id
string | null

Telematics/ELD vendor product identifier (catalog/model code).

total_axles
integer | null

Total number of axles on the trailer.

trailer_groups
Trailer Groups · object

JSON map of group memberships/tags for this trailer (segmentation/permissions).

external_id
string | null

External trailer identifier as known in the TSP or customer's system.

trailer_length
number | null

Length of the trailer (numeric; unit per source, e.g., feet or meters).

trailer_type
string | null

Body type/classification (e.g., Dry Van, Reefer, Flatbed, Tanker, Chassis).

speed_unit
string | null

Unit of measure for speed metrics (e.g., 'km/h', 'mph').

odometer_unit
string | null

Unit of measure for odometer readings (e.g., 'km', 'mi').

fuel_unit
string | null

Unit of measure for fuel quantities (e.g., 'gallons', 'liters').

fuel_capacity
string | null

Fuel capacity as provided by the source (text with units, e.g., '100 gallons').

engine_type
string | null

Power unit type for auxiliary equipment (e.g., reefer engine: 'diesel', 'electric').