Skip to main content
POST
/
v2
/
telematics
/
dvir-logs
Create Dvir Log
curl --request POST \
  --url https://api.catenatelematics.com/v2/telematics/dvir-logs \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "connection_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
'
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}

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.

Provisional endpoint
This endpoint is available for early access. The core schema is stable, but minor details — such as field names or added fields — may change before it becomes generally available. Backward compatibility is not guaranteed.

See API Stability & Versioning for details on provisional endpoints.

Authorizations

​
Authorization
string
header
required

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

Body

application/json

DvirLog model for creating new records.

​
connection_id
string<uuid>
required

Unique identifier of the connection at Catena Telematics which will be used to create this resource. A connection represents a Fleet/TSP pairing.

​
fleet_ref
string | null

External fleet reference in the partner system.

​
source_driver_id
string | null

External system identifier for the driver

​
source_vehicle_id
string | null

External system identifier for the vehicle

​
source_trailer_id
string | null

External system identifier for the trailer

​
occurred_at
string<date-time> | null

Datetime of when the inspection occurred (must be UTC)

​
log_type
enum<string>
default:unknown

Type of DVIR log. Defaults to unknown when omitted.

Available options:
pre_trip,
post_trip,
mechanic,
unknown
​
inspected_by
string | null

Name of the inspector conducting the DVIR

​
defect_count
integer | null

Total number of defects reported in this DVIR log. Defaults to 0 when omitted and no defects provided.

​
defects
enum<string>[] | null

List of defects reported in this DVIR log

Enum for DVIR (Driver Vehicle Inspection Report) defects

Available options:
fluid_levels,
battery,
belts_hoses,
radiator,
frame_assembly,
front_axle,
starter,
transmission,
oil_pressure,
defroster_heater,
lights_front,
windshield_clean,
windshield_wiper_fluid,
windshield_wipers,
brakes,
brake_check,
clutch,
mirrors,
horn,
safety_equipment,
trip_recorder,
air_conditioner,
doors,
stop_arm_control,
steering_wheel,
emergency_door_buzzer,
entrance_steps,
interior_floor,
windows,
exhaust,
fifth_wheel,
landing_gear,
suspension,
rims,
tires,
tire_chains,
stop_arm,
muffler,
roof,
wheels,
wheels_rims,
suspension_under,
scratches,
air_compressor,
air_lines,
brake_connections,
coupling_devices,
reflectors,
lights_rear,
rear_end,
tire_chains_rear,
brake_accessories,
drive_line,
engine,
fuel_tanks,
lights_general,
other,
unset,
first_aid_kit
​
is_safety_critical
boolean | null

Indicates whether the DVIR log is safety-critical

​
driver_comment
string | null

Additional free-text comments provided by the driver

​
certify_comment
string | null

Driver's certification comment acknowledging the inspection

​
odometer
number | null

Vehicle odometer reading at the time of the DVIR

​
odometer_unit
enum<string> | null

Unit for odometer

Available options:
miles,
meters,
kilo_meters

Response

The request to create the DVIR log has been accepted and is being processed.

Resource operation model for API responses

​
id
string<uuid>
required

Unique identifier for the resource operation.