--- title: "[legacy] Get all DVIRs" method: GET path: "/fleet/dvirs/history" tags: ["Legacy APIs"] --- # \[legacy\] Get all DVIRs `GET /fleet/dvirs/history` ## Request - Base URL: `https://api.samsara.com` - URL: `https://api.samsara.com/fleet/dvirs/history` - Auth: HTTP bearer **Note: This is a legacy endpoint, consider using [this endpoint](https://developers.samsara.com/reference/getdvirs) instead. The endpoint will continue to function as documented.** Returns a list of all DVIRs in an 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 **Read DVIRs** under the Maintenance category when creating or editing an API token. Learn More. ## Query parameters - `limit` integer - `after` string - `parentTagIds` string[] - `tagIds` string[] - `startTime` string, required - `endTime` string, required ## Response `200` List of all DVIRs in the organization - DvirsListResponse: A list of DVIRs and pagination information. - `data` Dvir[], required: A list of DVIRs. - `authorSignature` DvirAuthorSignature: DVIR Signure. - `signatoryUser` object: A minified user object. - `id` string: ID of the user. - `name` string: Name of the user. - `signedAtTime` string: The time when the DVIR was signed. UTC timestamp in RFC 3339 format. Example: `2020-01-27T07:06:25Z`. - `type` 'driver' | 'mechanic': Whether the DVIR was submitted by a `driver` or `mechanic`. Valid values: `driver`, `mechanic`. - `endTime` string: Time when driver signed and completed this DVIR. UTC timestamp in RFC 3339 format. Example: `2020-01-27T07:06:25Z`. - `id` string, required: Unique Samsara ID for the DVIR. - `licensePlate` string: The license plate of this vehicle. - `location` string: Optional string if your jurisdiction requires a location of the DVIR. - `mechanicNotes` string: The mechanics notes on the DVIR. - `odometerMeters` integer: The odometer reading in meters. - `safetyStatus` 'safe' | 'unsafe' | 'resolved': The condition of vehicle on which DVIR was done. Valid values: `safe`, `unsafe`, `resolved`. - `secondSignature` DvirSecondSignature: DVIR Signure. - `signatoryUser` object: A minified user object. - `id` string: ID of the user. - `name` string: Name of the user. - `signedAtTime` string: The time when the DVIR was signed. UTC timestamp in RFC 3339 format. Example: `2020-01-27T07:06:25Z`. - `type` 'driver' | 'mechanic': Whether the DVIR was submitted by a `driver` or `mechanic`. Valid values: `driver`, `mechanic`. - `startTime` string: Time when driver began filling out this DVIR. UTC timestamp in RFC 3339 format. Example: `2020-01-27T07:06:25Z`. - `thirdSignature` DvirThirdSignature: DVIR Signure. - `signatoryUser` object: A minified user object. - `id` string: ID of the user. - `name` string: Name of the user. - `signedAtTime` string: The time when the DVIR was signed. UTC timestamp in RFC 3339 format. Example: `2020-01-27T07:06:25Z`. - `type` 'driver' | 'mechanic': Whether the DVIR was submitted by a `driver` or `mechanic`. Valid values: `driver`, `mechanic`. - `trailer` DvirTrailer: A minified trailer object. - `id` string: ID of the trailer. - `name` string: Name of the trailer. - `trailerDefects` DvirTrailerDefectsItems[]: Defects registered for the trailer which was part of the DVIR. - `comment` string: Comment on the defect. - `createdAtTime` string: Time when the defect was created. UTC timestamp in RFC 3339 format. Example: `2020-01-27T07:06:25Z`. - `defectType` string: The type of DVIR defect. - `id` string, required: ID of the defect. - `isResolved` boolean, required: Signifies if this defect is resolved. - `mechanicNotes` string: The mechanics notes on the defect. - `mechanicNotesUpdatedAtTime` string: Time when mechanic notes were last updated. UTC timestamp in RFC 3339 format. Example: `2020-01-27T07:06:25Z`. - `resolvedAtTime` string: Time when this defect was resolved. Will not be returned if the defect is unresolved. UTC timestamp in RFC 3339 format. Example: `2020-01-27T07:06:25Z`. - `resolvedBy` DefectResolvedBy: The person who resolved this defect. Will not be returned if the defect is unresolved. - `id` string: ID of the entity that resolved this defect. If the defect was resolved by a driver, this will be a Samsara Driver ID. If the defect was resolved by a mechanic, this will be the Samsara Dashboard User ID of the mechanic. - `name` string: Name of the person who resolved this defect. - `type` 'driver' | 'mechanic': Indicates whether this defect was resolved by a `driver` or a `mechanic`. - `trailer` object: A minified trailer object. - `id` string: ID of the trailer. - `name` string: Name of the trailer. - `vehicle` object: A minified vehicle object. - `ExternalIds` object: The [external IDs](https://developers.samsara.com/docs/external-ids) for the given object. - `id` string: ID of the vehicle. - `name` string: Name of the vehicle. - `trailerName` string: The name of the trailer the DVIR was submitted for. Only included for tractor+trailer DVIRs. - `type` 'preTrip' | 'postTrip' | 'mechanic' | 'unspecified': Inspection type of the DVIR. Valid values: `preTrip`, `postTrip`, `mechanic`, `unspecified`. - `vehicle` DvirVehicle: A minified vehicle object. - `ExternalIds` object: The [external IDs](https://developers.samsara.com/docs/external-ids) for the given object. - `id` string: ID of the vehicle. - `name` string: Name of the vehicle. - `vehicleDefects` DvirTrailerDefectsItems[]: Defects registered for the vehicle which was part of the DVIR. - `comment` string: Comment on the defect. - `createdAtTime` string: Time when the defect was created. UTC timestamp in RFC 3339 format. Example: `2020-01-27T07:06:25Z`. - `defectType` string: The type of DVIR defect. - `id` string, required: ID of the defect. - `isResolved` boolean, required: Signifies if this defect is resolved. - `mechanicNotes` string: The mechanics notes on the defect. - `mechanicNotesUpdatedAtTime` string: Time when mechanic notes were last updated. UTC timestamp in RFC 3339 format. Example: `2020-01-27T07:06:25Z`. - `resolvedAtTime` string: Time when this defect was resolved. Will not be returned if the defect is unresolved. UTC timestamp in RFC 3339 format. Example: `2020-01-27T07:06:25Z`. - `resolvedBy` DefectResolvedBy: The person who resolved this defect. Will not be returned if the defect is unresolved. - `id` string: ID of the entity that resolved this defect. If the defect was resolved by a driver, this will be a Samsara Driver ID. If the defect was resolved by a mechanic, this will be the Samsara Dashboard User ID of the mechanic. - `name` string: Name of the person who resolved this defect. - `type` 'driver' | 'mechanic': Indicates whether this defect was resolved by a `driver` or a `mechanic`. - `trailer` object: A minified trailer object. - `id` string: ID of the trailer. - `name` string: Name of the trailer. - `vehicle` object: A minified vehicle object. - `ExternalIds` object: The [external IDs](https://developers.samsara.com/docs/external-ids) for the given object. - `id` string: ID of the vehicle. - `name` string: Name of the vehicle. - `pagination` PaginationResponse, required: Pagination parameters. - `endCursor` string, string, required: Cursor identifier representing the last element in the response. This value should be used in conjunction with a subsequent request's 'after' query parameter. This may be an empty string if there are no more pages left to view. - `hasNextPage` boolean, required: True if there are more pages of results immediately available after this endCursor. ## Other responses - `default`: Error response --- [API](https://skmtc.dev/samsara/apis/samsara-api.md) - [All operations](https://skmtc.dev/samsara/apis/samsara-api/llms.txt) - [OpenAPI document](https://skmtc.dev/samsara/apis/samsara-api/revisions/a9e35d4999be?raw)