List vehicle check submissions

GET

vehicle_checklist_submissions

curl --request GET \
  --url https://app.detrack.com/api/v2/dn/vehicle_checklist_submissions \
  --header 'X-API-KEY: <api-key>'

const options = {method: 'GET', headers: {'X-API-KEY': '<api-key>'}};

fetch('https://app.detrack.com/api/v2/dn/vehicle_checklist_submissions', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.detrack.com/api/v2/dn/vehicle_checklist_submissions",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-API-KEY: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://app.detrack.com/api/v2/dn/vehicle_checklist_submissions"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-API-KEY", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://app.detrack.com/api/v2/dn/vehicle_checklist_submissions")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-API-KEY"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "data": [
    {
      "id": "6905a1c3e8ec54cbf4a05e20",
      "organisation_id": "5b22055510c92b1a046ece01",
      "vehicle_checklist_id": "6901f0a2e8ec54cbf4a05b0f",
      "vehicle_checklist_name": "Start of day",
      "trackable_id": "5b2205f610c92b1a046ece0a",
      "trackable_name": "Truck 12",
      "detrack_id": "DT-1042",
      "started_at": "2026-11-03T08:40:02.118+08:00",
      "created_at": "2026-11-03T08:42:18.204+08:00",
      "updated_at": "2026-11-03T08:42:18.204+08:00",
      "passed_item_count": 11,
      "failed_item_count": 1,
      "signature_name": "Daniel Reyes",
      "signature_url": "<string>",
      "vehicle_checklist_is_approval": false,
      "approval_status": "approved",
      "approval_user_id": "<string>",
      "approval_user_name": "<string>",
      "approval_user_email": "<string>",
      "approval_date": "2026-11-03T09:05:41.000+08:00",
      "items": [
        {
          "id": "6905a1c3e8ec54cbf4a05e21",
          "vehicle_checklist_item_id": "6901f0a2e8ec54cbf4a05b10",
          "vehicle_checklist_item_name": "Odometer",
          "value": "48210",
          "notes": "<string>",
          "photo_1_url": "<string>",
          "photo_2_url": "<string>",
          "photo_3_url": "<string>",
          "photo_4_url": "<string>",
          "created_at": "2026-11-03T08:42:18.204+08:00",
          "updated_at": "2026-11-03T08:42:18.204+08:00"
        }
      ]
    }
  ],
  "links": {
    "first": "<string>",
    "last": "<string>",
    "next": "<string>",
    "prev": "<string>"
  },
  "total_count": 1
}

Pull the vehicle checks your drivers submitted, for example each day’s start-of-day and end-of-day checks, into your own fleet or compliance system. Results are newest first. Filter by submission date with from and to, and narrow them by vehicle, checklist, or pass/fail result.

Photo and signature links expire about 15 minutes after the response. Download the files you need straight away. Don’t store the links.

Known issues:

If a checklist was deleted after drivers submitted it, any page that includes one of its submissions returns 500. Narrow the list with checklist_id or from / to to skip those submissions (DTR-7093).
status=pass returns every submission with no failed answer, including checks with no pass/fail questions. To keep only checks where something passed, also check that passed_item_count is greater than 0 (DTR-7094).
For a manager whose access is limited to groups, assign_to has no effect, and the list includes every vehicle in their groups. Filter by trackable_id in the response instead (DTR-7095).

For what each field means, including where to find an odometer reading, see Vehicle checks. For errors and rate limits, see Errors and Rate limits.

Authorizations

X-API-KEY

string

header

required

Your Detrack API key, from Integrations > API Key in the dashboard.

Query Parameters

from

string<date>

Earliest submission date (YYYY-MM-DD) in your organisation's time zone, inclusive.

Example:

"2026-11-01"

string<date>

Latest submission date (YYYY-MM-DD) in your organisation's time zone, inclusive.

Example:

"2026-11-03"

assign_to

string

Vehicle IDs (trackable_id), comma-separated. Currently has no effect for a manager whose access is limited to groups.

Example:

"5b2205f610c92b1a046ece0a"

checklist_id

string

Checklist IDs (vehicle_checklist_id), comma-separated.

Example:

"6901f0a2e8ec54cbf4a05b0f"

status

enum<string>

fail returns submissions with at least one failed pass/fail question. pass returns submissions with no failed question, which includes submissions that have no pass/fail questions at all.

Available options:

pass,

fail

string

Case-insensitive text to match in the vehicle name (trackable_name) or the checklist name.

Example:

"Truck"

string

Submission IDs, comma-separated.

page

integer

default:1

Page number.

limit

integer

default:25

Records per page. Values over 100 are treated as 100.

Required range: x <= 100

Response

A page of vehicle check submissions.

data

object[]

Show child attributes

links

object

Show child attributes

total_count

integer

Example:

1

List vehicle check submissions

curl --request GET \
  --url https://app.detrack.com/api/v2/dn/vehicle_checklist_submissions \
  --header 'X-API-KEY: <api-key>'

const options = {method: 'GET', headers: {'X-API-KEY': '<api-key>'}};

fetch('https://app.detrack.com/api/v2/dn/vehicle_checklist_submissions', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.detrack.com/api/v2/dn/vehicle_checklist_submissions",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-API-KEY: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://app.detrack.com/api/v2/dn/vehicle_checklist_submissions"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-API-KEY", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://app.detrack.com/api/v2/dn/vehicle_checklist_submissions")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-API-KEY"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "data": [
    {
      "id": "6905a1c3e8ec54cbf4a05e20",
      "organisation_id": "5b22055510c92b1a046ece01",
      "vehicle_checklist_id": "6901f0a2e8ec54cbf4a05b0f",
      "vehicle_checklist_name": "Start of day",
      "trackable_id": "5b2205f610c92b1a046ece0a",
      "trackable_name": "Truck 12",
      "detrack_id": "DT-1042",
      "started_at": "2026-11-03T08:40:02.118+08:00",
      "created_at": "2026-11-03T08:42:18.204+08:00",
      "updated_at": "2026-11-03T08:42:18.204+08:00",
      "passed_item_count": 11,
      "failed_item_count": 1,
      "signature_name": "Daniel Reyes",
      "signature_url": "<string>",
      "vehicle_checklist_is_approval": false,
      "approval_status": "approved",
      "approval_user_id": "<string>",
      "approval_user_name": "<string>",
      "approval_user_email": "<string>",
      "approval_date": "2026-11-03T09:05:41.000+08:00",
      "items": [
        {
          "id": "6905a1c3e8ec54cbf4a05e21",
          "vehicle_checklist_item_id": "6901f0a2e8ec54cbf4a05b10",
          "vehicle_checklist_item_name": "Odometer",
          "value": "48210",
          "notes": "<string>",
          "photo_1_url": "<string>",
          "photo_2_url": "<string>",
          "photo_3_url": "<string>",
          "photo_4_url": "<string>",
          "created_at": "2026-11-03T08:42:18.204+08:00",
          "updated_at": "2026-11-03T08:42:18.204+08:00"
        }
      ]
    }
  ],
  "links": {
    "first": "<string>",
    "last": "<string>",
    "next": "<string>",
    "prev": "<string>"
  },
  "total_count": 1
}

Jobs

Depots

Routes

Vehicle checks

List vehicle check submissions

Authorizations

Query Parameters

Response