List Trucks

GET /locations/{location_id}/trucks

List truck profiles.

Roles

Users with the following roles may access this endoint:

Admin
ClientCustomer
CrmUser
Dispatcher
Driver
ThirdPartyDispatcher
ThirdPartyDriver

Breaking Changes

No breaking changes.

Request

Sample Request

GET /locations/{location_id}/trucks/
Authorization: Bearer {your-auth-token}
Content-Type: application/json
x-tenant-id: {your-tenant-id}

Sample Response

Access-Control-Allow-Headers: Authorization, Accept, X-TENANT-ID, Content-Type
Access-Control-Allow-Methods: GET
Access-Control-Allow-Origin: *
Allow: GET
Content-Length: 1672
Content-Type: application/json
Date: Sat, 20 Aug 2022 01:43:28 GMT
Server: WSGIServer/0.2 CPython/3.9.5
X-API-VERSION: 2019/02/08
X-REQUEST-ID: 62ea90da-adb2-4355-9ffc-e0694381270d

{
"current_limit": 100,
"current_page": 1,
"results": [
  {
    "driver_id": 100019,
    "id": 2,
    "interface_color": "#8000FF",
    "location_id": 1,
    "name": "Big Red",
    "notes": "Qly Penn",
    "out_of_service": true,
    "require_odometer": false,
    "third_party_hauler_id": null,
    "trailer_id": null,
    "type": "Rolloff",
    "weight": 36500.0
  },
  {
    "driver_id": 100019,
    "id": 6,
    "interface_color": "#E000C6",
    "location_id": 1,
    "name": "Kenworth ",
    "notes": "All Areas",
    "out_of_service": false,
    "require_odometer": false,
    "third_party_hauler_id": null,
    "trailer_id": null,
    "type": "Rolloff",
    "weight": 0.0
  },
  {
    "driver_id": 100001,
    "id": 1,
    "interface_color": "#F10700",
    "location_id": 1,
    "name": "Mack Truck",
    "notes": "Sequim Wa",
    "out_of_service": false,
    "require_odometer": false,
    "third_party_hauler_id": null,
    "trailer_id": null,
    "type": "Rolloff",
    "weight": 38000.0
  },
  {
    "driver_id": 100001,
    "id": 16,
    "interface_color": "#008040",
    "location_id": 1,
    "name": "Truck #1",
    "notes": "Sequim ",
    "out_of_service": false,
    "require_odometer": false,
    "third_party_hauler_id": null,
    "trailer_id": null,
    "type": "Rolloff",
    "weight": 17500.0
  },
  {
    "driver_id": 100014,
    "id": 17,
    "interface_color": "#FF8000",
    "location_id": 1,
    "name": "Truck #2",
    "notes": "Port Angeles",
    "out_of_service": false,
    "require_odometer": false,
    "third_party_hauler_id": null,
    "trailer_id": null,
    "type": "Rolloff",
    "weight": 18760.0
  },
  {
    "driver_id": null,
    "id": 18,
    "interface_color": "#00FF80",
    "location_id": 1,
    "name": "Truck #3",
    "notes": "Port Townsend",
    "out_of_service": false,
    "require_odometer": false,
    "third_party_hauler_id": null,
    "trailer_id": null,
    "type": "Flat Bed",
    "weight": 21450.0
  }
],
"total_count": 33,
"total_pages": 1
}

Path Parameters

location_id Integer, Required

Location identifier.

Query Parameters

page_index Integer, Optional

Paged results page index (starting from 1).

• Less than or equal to 10000.
• Greater than or equal to 1.

---

page_limit Integer, Optional

Maximun number of results per page.

• Less than or equal to 1000.
• Greater than or equal to 1.

Request Headers

Refer to StandardRequestHeadersModel for more details.

authorization String, Required

Authorization header (bearer with access token). See the Authentication Guide to get started.

• Matches ^bearer [a-z0-9-_=]+.[a-z0-9-_=]+.?[a-z0-9-_.+/=]*$
• No longer than 256 characters.
• At least 1 characters long.

---

x-api-version String, Optional

Request identifier.

• At least 1 and no more than 64 characters.
• Must be a valid API version string (2019/02/08, 2021/04/07, 2021/05/07, 2021/08/02, 2021/11/04, 2023/04/19).

---

x-tenant-id Integer, Required

Tenant identifier. Contact CRO Software for more info if you don't already have this id. See list tenant ids for info on listing the tenants you have access to.

Request Body

note

No request body

Response

Response Headers

Refer to StandardResponseHeadersModel for more details.

x-api-version String

Request identifier.

• At least 1 and no more than 64 characters.
• Must be a valid API version string (2019/02/08, 2021/04/07, 2021/05/07, 2021/08/02, 2021/11/04, 2023/04/19).

---

x-request-id String

Request identifier.

• Valid UUID.

Response Body

Refer to TruckListModel for more details.

current_limit Integer

Maximun number of results per page.

• Less than or equal to 1000.
• Greater than or equal to 1.

---

current_page Integer

Paged results page index (starting from 1).

• Less than or equal to 10000.
• Greater than or equal to 1.

---

results Array[TruckModel]

Refer to TruckModel.

---

total_count Integer

Paged results total viewable records.

• Less than or equal to 100000.
• Greater than or equal to 0.

---

total_pages Integer

Paged results total pages.

• Less than or equal to 1000.
• Greater than or equal to 0.

Code Samples

cURL

curl --request GET --include \
--header "Authorization: Bearer {your-auth-token}" \
--header "Content-Type: application/json" \
--header "x-tenant-id: {your-tenant-id}" \
127.0.0.1:8003/locations/{location_id}/trucks

Python

import requests, json

response = requests.get(
  'http://localhost:8003/locations/{location_id}/trucks',
  headers={
    'Authorization': 'Bearer {your-auth-token}',
    'Content-Type': 'application/json',
    'x-tenant-id': '{your-tenant-id}'
  },
  parameters={
  }
)
results = json.loads(response.text)
print(results)

CSharp 2.0

using System;
using System.Net;
using System.Collections.Specialized;

namespace CROSoftware
{
public class DemoClient
{
    static public void Main ()
    {
        WebClient client = new WebClient();

        // URL    
        String url = "/locations/{location_id}/trucks";

        // Headers
        client.Headers.Add("Authorization", "Bearer {your-auth-token}");
        client.Headers.Add("Content-Type", "application/json");
        client.Headers.Add("x-tenant-id", "{your-tenant-id}");

        string json = client.DownloadString(url);
        Console.WriteLine(json);
    }
}
}