Documentation :: AllTruckJobs.com

AllTruckJobs API v2.0

Driver Data

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

Fetch drivers

GET https://www.alltruckjobs.com/api/v2.0/drivers.jsonxml

Parameters

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

Name Format/Values Required Description
certifications One of the following values:
  • Doubles/Triples (T)
  • HAZMAT (H)
  • Tank Vehicles (N)
  • Tanker + HAZMAT (X)
No Fetch only drivers with the specified endorsements.
driver_type One of the following values:
  • Owner Operator
  • Company Driver
  • Student
No Fetch only drivers with the specified driver type.
email Email No Fetch only drivers with the specified email address.
end_date YYYY-MM-DD or YYYY-MM-DDThh:mm:ss No Fetch only drivers who submitted their application to your company before the specified date or date/time.
first_name String No Fetch only drivers with the specified first name.
has_job_apps One of the following values:
  • 1
  • 0
No Fetch only drivers who have (1) or have not (0) applied to one of your jobs.
job_title String No Fetch only drivers who applied to a job of the specified title.
last_name String No Fetch only drivers with the specified last name.
lives_within_radius Integer > 0 No Fetch only drivers who live within the specified radius (in miles) of the location provided in lives_within_zip.
lives_within_zip ZIP code No Fetch only drivers who live within the radius (in miles) provided in lives_within_radius of the specified location.
max Integer > 0 No Maximum number of drivers to return.
min_experience One of the following values:
  • None
  • 1-5 months
  • 6-11 months
  • 1 year
  • 18 months
  • 2 years
  • 3 years
  • 4 or more years
No Fetch only drivers with at least the specified minimum experience.
phone Phone No Fetch only drivers with the specified phone number.
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/time they submitted their application to your company.

start_date YYYY-MM-DD or YYYY-MM-DDThh:mm:ss No Fetch only drivers who submitted their application to your company after the specified date or date/time.
state USPS 2-letter state abbreviation No Fetch only drivers who reside in the specified state.

Sample Request

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

GET https://www.alltruckjobs.com/api/v2.0/drivers.jsonxml?state=KY&driver_type=Student&sort=name&max=2

Sample Response

[
    {
        "id": 12345,
        "first_name": "John",
        "last_name": "Doe",
        "address": "1234 Example Street",
        "address2": "Suite 5678",
        "city": "Louisville",
        "state": "KY",
        "zip": "40210",
        "email": "[email protected]",
        "phone": "1234567890",
        "driver_type": "Company+Driver",
        "experience": "3 years",
        "sent": "2015-12-08T15:24:35-05:00",
        "has_job_apps": true
    },
    {
        "id": 67890,
        "first_name": "Jane",
        "last_name": "Smith",
        "address": "1234 Example Street",
        "address2": "Suite 5678",
        "city": "Lexington",
        "state": "KY",
        "zip": "40503",
        "email": "[email protected]",
        "phone": "1234657890",
        "driver_type": "Company+Driver",
        "experience": "6-11 months",
        "sent": "2015-12-08T15:24:35-05:00",
        "has_job_apps": false
    }
]
<?xml version="1.0"?>
<drivers>
  <driver>
    <id>12345</id>
    <first_name>John</first_name>
    <last_name>Doe</last_name>
    <address>1234 Example Street</address>
    <address2>Suite 5678</address2>
    <city>Louisville</city>
    <state>KY</state>
    <zip>40210</zip>
    <email>[email protected]</email>
    <phone>1234567890</phone>
    <driver_type>Company+Driver</driver_type>
    <experience>3 years</experience>
    <sent>2015-12-08T15:24:35-05:00</sent>
    <has_job_apps>1</has_job_apps>
  </driver>
  <driver>
    <id>67890</id>
    <first_name>Jane</first_name>
    <last_name>Smith</last_name>
    <address>1234 Example Street</address>
    <address2>Suite 5678</address2>
    <city>Lexington</city>
    <state>KY</state>
    <zip>40503</zip>
    <email>[email protected]</email>
    <phone>1234657890</phone>
    <driver_type>Company+Driver</driver_type>
    <experience>6-11 months</experience>
    <sent>2015-12-08T15:24:35-05:00</sent>
    <has_job_apps></has_job_apps>
  </driver>
</drivers>

Fetch a Single Driver

GET https://www.alltruckjobs.com/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 https://www.alltruckjobs.com/api/v2.0/drivers.jsonxml/12345

Sample Response

{
    "id": 12345,
    "first_name": "John",
    "last_name": "Doe",
    "address": "1234 Example Street",
    "address2": null,
    "city": "Louisville",
    "state": "KY",
    "zip": "40210",
    "sent": "2015-12-08T15:24:35-05:00",
    "email": "[email protected]",
    "phone": "1234567890",
    "driver_type": "Owner+Operator",
    "experience": "3 years",
    "endorsement": "Tanker + HAZMAT (X)",
    "freight_experience": "Yard Spotter",
    "freight_preferences": "Hopper Bottom",
    "license_number": "v0l2e5x6e0f9v6z8x0g9",
    "license_state": "Tennessee",
    "preferred_assignments": "OTR",
    "preferred_regions": "Midwest",
    "has_team": "",
    "license_class": "Class B",
    "date_of_birth": "01/10/1983",
    "accidents": "2",
    "moving_violations": "3",
    "last_license_suspension": 2018,
    "last_dui": 2014,
    "interested_lease_purchase": "No",
    "teams": "Both",
    "trucks_owned": "",
    "employment_history": [
        {
            "company": "Example Company",
            "state": "PA",
            "phone": "1234567890",
            "start_date": "2021-01-1",
            "end_date": null
        }
    ],
    "job_applications": [
        {
            "job_id": 10693,
            "title": "Example Job Title",
            "reference": "EXAMPLE12356",
            "created_at": "1986-08-17T23:45:13+00:00"
        }
    ],
    "is_premium": false
}
<?xml version="1.0"?>
<drivers>
  <driver>
    <id>12345</id>
    <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>
    <sent>2015-12-08T15:24:35-05:00</sent>
    <email>[email protected]</email>
    <phone>1234567890</phone>
    <driver_type>Owner+Operator</driver_type>
    <experience>3 years</experience>
    <endorsement>Tanker + HAZMAT (X)</endorsement>
    <freight_experience>Yard Spotter</freight_experience>
    <freight_preferences>Hopper Bottom</freight_preferences>
    <license_number>v0l2e5x6e0f9v6z8x0g9</license_number>
    <license_state>Tennessee</license_state>
    <preferred_assignments>OTR</preferred_assignments>
    <preferred_regions>Midwest</preferred_regions>
    <has_team></has_team>
    <license_class>Class B</license_class>
    <date_of_birth>01/10/1983</date_of_birth>
    <accidents>2</accidents>
    <moving_violations>3</moving_violations>
    <last_license_suspension>2018</last_license_suspension>
    <last_dui>2014</last_dui>
    <interested_lease_purchase>No</interested_lease_purchase>
    <teams>Both</teams>
    <trucks_owned></trucks_owned>
    <employment_history>
      <company>Example Company</company>
      <state>PA</state>
      <phone>1234567890</phone>
      <start_date>2021-01-1</start_date>
      <end_date></end_date>
    </employment_history>
    <job_applications>
      <job_id>10693</job_id>
      <title>Example Job Title</title>
      <reference>EXAMPLE12356</reference>
      <created_at>1986-08-17T23:45:13+00:00</created_at>
    </job_applications>
    <is_premium></is_premium>
  </driver>
</drivers>