DVIRReport

  • This method returns DVIR report data for the requested date range.
  • Returns the following fields:
    1. sourceId
    2. driverId
    3. driverName
    4. conditionOK
    5. status
    6. created (UTC datetime)
    7. updated (UTC datetime)
    8. remarks
    9. mechanicName
    10. tripStatus
    11. odometer
    12. defectsCorrected
    13. defectsNeedNotBeCorrected
    14. form

Form Object Details

  • form: DVIR template metadata object.
  • form.id, form.name: Template identifier and template name.
  • form.categories[]: Logical checklist sections (for example: Vehicle, Trailer).
  • form.categories[].id, form.categories[].name: Category metadata.
  • form.categories[].fields[]: Category checklist items.
  • fields[].id: Field identifier.
  • fields[].name: Field label.
  • fields[].isChecked: Indicates if the defect item is selected.
  • fields[].description: Optional free-text note for the field.
  • fields[].type: Item type code from WLUS.
  • Note: categories/fields are template-driven and may change over time. Iterate arrays dynamically instead of hardcoding positions.

Request URL

[GET] https://secure.trackyourtruck.com/WebApi/api/v2.2/GetDVIRReport

Request Header

The request header should contain the API Access Token obtained from the authentication process. Get Access Token.

Request Parameters

Parameter Name Description Value Format Example
from Beginning date* yyyy-mm-dd 2026-04-29
to Ending date* yyyy-mm-dd 2026-04-29
PageNumber (Optional) Page number to return. Default: 1 numeric 1
PageSize (Optional) Number of records per page. Default: 100 numeric 100

Sample Response

{
  "StatusCode": "200",
  "Message": "OK",
    "Results": [
        {
            "sourceId": "7897",
            "driverId": "13",
            "driverName": "Robbie Hall Jr",
            "conditionOk": true,
            "status": 1,
            "created": "2026-05-12T12:19:35Z",
            "updated": "2026-05-12T12:19:56Z",
            "remarks": null,
            "mechanicName": null,
            "tripStatus": "pre",
            "odometer": 63812.00,
            "defectsCorrected": false,
            "defectsNeedNotBeCorrected": false,
            "form": {
                "categories": [
                    {
                        "fields": [
                            {
                                "description": "",
                                "id": 1,
                                "isChecked": false,
                                "name": "Air Compressor",
                                "type": 0
                            },
                            {
                                "description": "",
                                "id": 2,
                                "isChecked": false,
                                "name": "Heater",
                                "type": 0
                            },
                            {
                                "description": "",
                                "id": 3,
                                "isChecked": false,
                                "name": "Safety Eq. - Flags-Flares-Fusee",
                                "type": 0
                            },
                            {
                                "description": "",
                                "id": 4,
                                "isChecked": false,
                                "name": "Air Lines",
                                "type": 0
                            },
                            {
                                "description": "",
                                "id": 5,
                                "isChecked": false,
                                "name": "Horn",
                                "type": 0
                            }
                        ],
                        "id": 1,
                        "name": "Vehicle"
                    }
                ],
                "id": 1,
                "name": "default"
            }
        }
  ]
}

Test