Create a mechanic DVIR

Creates a new mechanic DVIR in the organization.

Submit Feedback: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team.

To use this endpoint, select Write DVIRs under the Maintenance category when creating or editing an API token. Learn More.

POST /fleet/dvirs

Create a mechanic DVIR

cURL

curl --request POST \
  --url https://api.samsara.com/fleet/dvirs \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "authorId": "11",
  "safetyStatus": "safe",
  "type": "mechanic",
  "licensePlate": "XHK1234",
  "location": "350 Rhode Island St Ste. 400S, San Francisco, CA 94103",
  "mechanicNotes": "Replaced headlight on passenger side.",
  "odometerMeters": 14010293,
  "resolvedDefectIds": [
    "<string>"
  ],
  "trailerId": "11",
  "vehicleId": "10"
}
'

200

{
  "data": {
    "id": "7107471",
    "authorSignature": {
      "signatoryUser": {
        "id": "88668",
        "name": "Susan Bob"
      },
      "signedAtTime": "2020-01-27T07:06:25Z",
      "type": "driver"
    },
    "endTime": "2020-01-27T07:06:25Z",
    "licensePlate": "XHK1234",
    "location": "350 Rhode Island St Ste. 400S, San Francisco, CA 94103",
    "mechanicNotes": "Replaced headlight on passenger side.",
    "odometerMeters": 14010293,
    "safetyStatus": "unsafe",
    "secondSignature": {
      "signatoryUser": {
        "id": "88668",
        "name": "Susan Bob"
      },
      "signedAtTime": "2020-01-27T07:06:25Z",
      "type": "driver"
    },
    "startTime": "2020-01-27T07:06:25Z",
    "thirdSignature": {
      "signatoryUser": {
        "id": "88668",
        "name": "Susan Bob"
      },
      "signedAtTime": "2020-01-27T07:06:25Z",
      "type": "driver"
    },
    "trailer": {
      "id": "123456789",
      "name": "Midwest Trailer #5"
    },
    "trailerDefects": [
      {
        "id": "18",
        "isResolved": true,
        "comment": "Air Compressor not working",
        "createdAtTime": "2020-01-27T07:06:25Z",
        "defectType": "Air Compressor",
        "mechanicNotes": "Extremely large oddly shaped hole in passenger side window.",
        "mechanicNotesUpdatedAtTime": "2020-01-27T07:06:25Z",
        "resolvedAtTime": "2020-01-27T07:06:25Z",
        "resolvedBy": {
          "id": "11",
          "name": "Christopher 'The Handyman' Zhen",
          "type": "driver"
        },
        "trailer": {
          "id": "123456789",
          "name": "Midwest Trailer #5"
        },
        "vehicle": {
          "ExternalIds": {
            "maintenanceId": "250020",
            "payrollId": "ABFS18600"
          },
          "id": "123456789",
          "name": "Midwest Truck #4"
        }
      }
    ],
    "trailerName": "Midwest Trailer #5",
    "type": "preTrip",
    "vehicle": {
      "ExternalIds": {
        "maintenanceId": "250020",
        "payrollId": "ABFS18600"
      },
      "id": "123456789",
      "name": "Midwest Truck #4"
    },
    "vehicleDefects": [
      {
        "id": "18",
        "isResolved": true,
        "comment": "Air Compressor not working",
        "createdAtTime": "2020-01-27T07:06:25Z",
        "defectType": "Air Compressor",
        "mechanicNotes": "Extremely large oddly shaped hole in passenger side window.",
        "mechanicNotesUpdatedAtTime": "2020-01-27T07:06:25Z",
        "resolvedAtTime": "2020-01-27T07:06:25Z",
        "resolvedBy": {
          "id": "11",
          "name": "Christopher 'The Handyman' Zhen",
          "type": "driver"
        },
        "trailer": {
          "id": "123456789",
          "name": "Midwest Trailer #5"
        },
        "vehicle": {
          "ExternalIds": {
            "maintenanceId": "250020",
            "payrollId": "ABFS18600"
          },
          "id": "123456789",
          "name": "Midwest Truck #4"
        }
      }
    ]
  }
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

The DVIR to create.

DVIR creation body

authorId · string · required

Samsara user ID of the mechanic creating the DVIR.

Example:

"11"

safetyStatus · enum<string> · required

Whether or not this vehicle or trailer is safe to drive.

Available options: safe, unsafe

Example:

"safe"

type · enum<string> · required

Only type 'mechanic' is currently accepted.

Available options: mechanic

Example:

"mechanic"

licensePlate · string

The license plate of this vehicle.

Maximum string length: 12

Example:

"XHK1234"

location · string

Optional string if your jurisdiction requires a location of the DVIR.

Example:

"350 Rhode Island St Ste. 400S, San Francisco, CA 94103"

mechanicNotes · string

The mechanics notes on the DVIR.

Example:

"Replaced headlight on passenger side."

odometerMeters · integer

The odometer reading in meters.

Example:

14010293

resolvedDefectIds · string[]

Array of ids for defects being resolved with this DVIR.

trailerId · string

Id of trailer being inspected. Either vehicleId or trailerId must be provided.

Example:

"11"

vehicleId · string

Id of vehicle being inspected. Either vehicleId or trailerId must be provided.

Example:

"10"

Response

200

application/json

Newly created DVIR.

The DVIR response.

data · object

Information about a DVIR.

Show child attributes