List

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
  }
]

GET

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

integer

Unique identifier for the driver agreement.

Example:

5001

vehicle

object

Vehicle associated with the driver agreement.

Show child attributes

vehicle.id

integer

Unique vehicle ID.

Example:

10001

vehicle.plate_number

string

Vehicle license plate number.

Example:

"ABC1234"

vehicle.plate_state

string

State of vehicle registration.

Example:

"TX"

vehicle.vehicle_number

string

Internal vehicle number or code.

Example:

"VEH001"

vehicle.vehicle_make

string

Make/brand of the vehicle.

Example:

"Toyota"

vehicle.vehicle_model

string

Model of the vehicle.

Example:

"Corolla"

vehicle.year

string

Year of manufacture.

Example:

"2023"

vehicle.lessee_renter

string | null

Name of the lessee or renter (if applicable).

Example:

null

vehicle.custom_fields

object

Custom vehicle fields.

Show child attributes

vehicle.custom_fields.Location

string

Location where the vehicle is stationed.

Example:

"Warehouse A"

vehicle.custom_fields.Equipment Number

string

Internal equipment number.

Example:

"EQ-5567"

vehicle.vehicle_type_code

string | null

Code representing the vehicle type.

Example:

"SEDAN"

vehicle.added_date

string<date-time>

Date when the vehicle was added to the fleet.

Example:

"2025-01-01T10:00:00Z"

vehicle.fleet

object

Fleet details the vehicle belongs to.

Show child attributes

vehicle.fleet.id

integer

Fleet ID.

Example:

10

vehicle.fleet.title

string

Name of the fleet.

Example:

"Demo Fleet"

vehicle.fleet.region_details

object[]

List of regions associated with the fleet.

Show child attributes

vehicle.fleet.region_details.id

integer

Region ID.

Example:

201

vehicle.fleet.region_details.title

string

Name of the region.

Example:

"Midwest"

vehicle.fleet.is_active

boolean

Whether the fleet is active.

Example:

true

vehicle.fleet.billing_type

string

Billing type for the fleet (e.g., PREPAID, POSTPAID).

Example:

"PREPAID"

vehicle.fleet.onboarding_stage

string

Stage of onboarding for the fleet.

Example:

"IN_PROGRESS"

vehicle.fleet.warning_threshold_per_vehicle

integer | null

Warning threshold for fleet vehicles.

Example:

null

vehicle.fleet.deactivation_threshold_per_vehicle

integer | null

Deactivation threshold for fleet vehicles.

Example:

null

vehicle.fleet.client

string | null

Linked client account, if any.

Example:

null

vehicle.fleet.onboarding_vehicle_order

integer

Vehicle order number during onboarding.

Example:

15

vehicle.active

boolean

Whether the vehicle is active in the system.

Example:

true

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

List

Add

⌘I

Introduction

Integrations

Auth

Vehicles

Fleet

Parking

Transponders

Tolls

Integrations

Drivers

Authorizations

Headers

Response