# Get tractor units list

Endpoint: GET /tractorUnits
Version: 1.0.0
Security: M2X_auth_application

## Response 200 fields (application/json):

  - `name` (string, required)
    Human identifier for the tractor unit
    Example: "T001"

  - `disabled` (boolean, required)

  - `registration` (string)
    Example: "ABC123"

  - `description` (string)
    Example: "unit 6"

  - `vin` (string)
    Example: "VIN123"

  - `externalId` (string)
    Example: "Human searchable external id"

  - `physicalConfiguration` (object)

  - `physicalConfiguration.heightMetres` (number)
    The height of the tractor unit
    Example: 2.1

  - `physicalConfiguration.tareWeightKg` (number)
    The tare weight of the tractor unit
    Example: 20000

  - `properties` (object)
    A key value store containing bespoke properties usable for pricing and optimisation

  - `metadata` (object)
    Opaque passenger data

  - `trackingProvider` (string,null)
    (optional) select which telematics to use (requires relevant telematics device id to be set)
    Enum: "EROAD", "MOTIVE", "MTDATA", "SAMSARA", "ORBCOMM", "MIX_TELEMATICS", "NONE"

  - `eroadVehicleId` (string,null)
    (optional) telematics device id

  - `motiveVehicleId` (string,null)
    (optional) telematics device id

  - `mtDataVehicleId` (string,null)
    (optional) telematics device id

  - `samsaraVehicleId` (string,null)
    (optional) telematics device id

  - `orbcommVehicleId` (string,null)
    (optional) telematics device id

  - `mixTelematicsVehicleId` (string,null)
    (optional) telematics device id

  - `readonlyFields` (object)
    Specifies which field should not be touched by the user

  - `readonlyFields.name` (boolean)

  - `readonlyFields.tareWeightKg` (boolean)

  - `readonlyFields.heightMetres` (boolean)

  - `readonlyFields.telematics` (boolean)

  - `updated` (string)

  - `id` (string)
    Example: "T001"