Documentation :: AllTruckJobs.com

AllTruckJobs API v1.0

Driver Data

The drivers endpoint is used to fetch application data submitted by drivers on AllTruckJobs.

Fetch drivers

GET /api/v2.0/drivers.jsonxml

Parameters

Parameters should be appended to the endpoint URL as a standard query string.

Name Format/Values Required Description
state USPS 2-letter abbreviation No Fetch only drivers who reside in the specified state
driver_type One of the following values:
  • Owner+Operator
  • Company+Driver
  • Student
No Fetch only drivers of the specified drivertype
start_date YYYY-MM-DD No Fetch only drivers who submitted their application to your company after the specified date
end_date YYYY-MM-DD No Fetch only drivers who submitted their application to your company before the specified date
sort One of the following values:
  • id
  • name
  • state
  • driver_type
  • sent
No Sort by the specified field. Defaults to ascending order; for descending order, put a - (hyphen) in front of the field name.

For example: -sent would sort the drivers in descending order based on the date they submitted their application to your company.
max Integer > 0 No Maximum number of drivers to return

Sample Request

To show only 2 company drivers in Kentucky, sorted alphabetically by name, your request would look like this:

GET /api/v2.0/drivers.jsonxml?state=KY&driver_type=Company+Driver&sort=name&max=2

Sample Response

[
    {
        "id": "12345",
        "first_name": "John",
        "last_name": "Doe",
        "email": "johndoe@test.com",
        "phone": "1234567890",
        "driver_type": "Owner+Operator",
        "city": "Louisville",
        "state": "KY",
        "zip": "40210",
        "sent": "2015-12-08T15:24:35-05:00"
    },
    {
        "id": "67890",
        "first_name": "Jane",
        "last_name": "Smith",
        "email": "janesmith@test.com",
        "phone": "1234657890",
        "driver_type": "Company+Driver",
        "city": "Lexington",
        "state": "KY",
        "zip": "40503",
        "sent": "2015-12-08T15:24:35-05:00"
    }
]
<?xml version="1.0"?>
<drivers>
  <driver>
    <id>67890</id>
    <first_name>Jane</first_name>
    <last_name>Smith</last_name>
    <email>janesmith@test.com</email>
    <phone>1234657890</phone>
    <driver_type>Student</driver_type>
    <city>Lexington</city>
    <state>KY</state>
    <zip>40503</zip>
    <sent>2015-12-08T15:24:35-05:00</sent>
  </driver>
</drivers>

Fetch a Single Driver

GET /api/v2.0/drivers.jsonxml/{id}

Parameters

Parameters should be appended to the endpoint URL.

Field Format/Values Required Description
id Integer Yes The ID number of the driver you want to fetch.

Sample Request

GET /api/v2.0/drivers.jsonxml/12345

Sample Response

{
    "first_name": "John",
    "last_name": "Doe",
    "address": "1234 Example Street",
    "address2": null,
    "city": "Louisville",
    "state": "KY",
    "zip": "40210",
    "email": "johndoe@test.com",
    "phone": "1234567890",
    "driver_type": "Owner+Operator",
    "experience": "2 years",
    "endorsement": "Tank Vehicles (N)",
    "freight_experience": "Dry Van",
    "freight_preferences": "Car Hauler",
    "license_number": "i9i3x0f6i4r9o1o6g0i2",
    "license_state": "Minnesota",
    "preferred_assignments": "LTL",
    "preferred_regions": "Southwest",
    "license_class": "Class B",
    "has_team": "",
    "date_of_birth": "09\/14\/1932",
    "accidents": "4",
    "moving_violations": "7",
    "last_license_suspension": 2011,
    "last_dui": 2010,
    "interested_team_driving": "No",
    "interested_lease_purchase": "No",
    "trucks_owned": ""
}
<?xml version="1.0"?>
<drivers>
  <driver>
    <first_name>John</first_name>
    <last_name>Doe</last_name>
    <address>1234 Example Street</address>
    <address2></address2>
    <city>Louisville</city>
    <state>KY</state>
    <zip>40210</zip>
    <email>johndoe@test.com</email>
    <phone>1234567890</phone>
    <driver_type>Student</driver_type>
    <experience>2 years</experience>
    <endorsement>HAZMAT (H)</endorsement>
    <freight_experience>Car Hauler</freight_experience>
    <freight_preferences>Reefer</freight_preferences>
    <license_number>d6d8k7h7n5z4a0e1p2e0</license_number>
    <license_state>Massachusetts</license_state>
    <preferred_assignments>Regional</preferred_assignments>
    <preferred_regions>Southwest</preferred_regions>
    <license_class>Class A</license_class>
    <has_team></has_team>
    <date_of_birth>02/19/1946</date_of_birth>
    <accidents>3</accidents>
    <moving_violations>5</moving_violations>
    <last_license_suspension>2018</last_license_suspension>
    <last_dui>2020</last_dui>
    <interested_team_driving>Yes</interested_team_driving>
    <interested_lease_purchase>Yes</interested_lease_purchase>
    <trucks_owned></trucks_owned>
  </driver>
</drivers>