GET
/
v2
/
driver-agreements
/
List Driver Agreements
curl --request GET \
  --url https://api.app.fleetit.com/v2/driver-agreements/ \
  --header 'Authorization: Bearer <token>' \
  --header 'Fleet-Id: <fleet-id>'
[
  {
    "id": 5001,
    "vehicle": {
      "id": 10001,
      "plate_number": "ABC1234",
      "plate_state": "TX",
      "vehicle_number": "VEH001",
      "vehicle_make": "Toyota",
      "vehicle_model": "Corolla",
      "year": "2023",
      "lessee_renter": null,
      "custom_fields": {
        "Location": "Warehouse A",
        "Equipment Number": "EQ-5567"
      },
      "vehicle_type_code": "SEDAN",
      "added_date": "2025-01-01T10:00:00Z",
      "fleet": {
        "id": 10,
        "title": "Demo Fleet",
        "region_details": [
          {
            "id": 201,
            "title": "Midwest"
          }
        ],
        "is_active": true,
        "billing_type": "PREPAID",
        "onboarding_stage": "IN_PROGRESS",
        "warning_threshold_per_vehicle": null,
        "deactivation_threshold_per_vehicle": null,
        "client": null,
        "onboarding_vehicle_order": 15
      },
      "active": true
    },
    "agreement_status": "ACTIVE",
    "agreement_start_date": "2025-03-01T00:00:00Z",
    "agreement_end_date": "2025-06-30T00:00:00Z",
    "date_added": "2025-02-01T12:00:00Z",
    "last_updated": "2025-02-15T15:30:00Z",
    "agreement_number": "AGMT-2025-001",
    "driver": 3001,
    "parent_agreement": null
  }
]

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

​
Fleet-Id
integer
required

ID of the Fleet making the request.

Example:

123

Response

200 - application/json

Successful Response

​
id
integer

Unique identifier for the driver agreement.

Example:

5001

​
vehicle
object

Vehicle associated with the driver agreement.

​
agreement_status
string

Current status of the agreement (e.g., ACTIVE, EXPIRED).

Example:

"ACTIVE"

​
agreement_start_date
string<date-time>

Start date of the agreement.

Example:

"2025-03-01T00:00:00Z"

​
agreement_end_date
string<date-time>

End date of the agreement.

Example:

"2025-06-30T00:00:00Z"

​
date_added
string<date-time>

Date the agreement was added to the system.

Example:

"2025-02-01T12:00:00Z"

​
last_updated
string<date-time>

Date the agreement was last updated.

Example:

"2025-02-15T15:30:00Z"

​
agreement_number
string

Unique agreement number.

Example:

"AGMT-2025-001"

​
driver
integer

ID of the driver linked to this agreement.

Example:

3001

​
parent_agreement
string | null

ID of the parent agreement if this is a sub-agreement.

Example:

null