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_name": "ada",
  "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>"
}

Documentation Index

Fetch the complete documentation index at: https://docs.catenatelematics.com/llms.txt

Use this file to discover all available pages before exploring further.

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