Fulfillment API

VehicleRequest

object

Details of a vehicle.

vehicleAttributesarray[object]

Details of a vehicle attribute.

Show Child Parameters
vehicleIdstring(uuid)

The ID of the vehicle. A UUID will be assigned if not sent.

Example:b331c130-e89b-12d3-a456-426614174000

externalVehicleIdstring

A vehicle identifier managed by the user. Shippers can use this field to map Central Dispatch dispatch ID to a vehicle record in their local TMS.

Example:EXT123456

vinstring

The vehicle identification number (VIN). Required if year, make, model values are not supplied.

Example:KL8CH6SA6NC001234

distancenumber(double)

The total travel distance.

Example:267

distanceUnitsstring

The units of distance.

Default:MILES

Example:MILES

pickUpLocationIdinteger(int32)

The stop number (the sequential number of the stop along the route) of the pick up location.

Example:1

dropOffLocationIdinteger(int32)

The stop number (the sequential number of the stop along the route) of the delivery location.

Example:2

carrierPricenumber(double)

The price to be paid to the carrier for completing the delivery of this vehicle (reference only).

Example:500

carrierPriceUnitsstring

The currency of carrierPrice.

Default:USD

Example:USD

typestring

The type of vehicle e.g. CAR, TRUCK.

Allowed values:ATVBOATCARHEAVY_EQUIPMENTLARGE_YACHTMOTORCYCLEPICKUPRVSUVTRAVEL_TRAILERVANOTHER

Example:CAR

sizestring

The size of the vehicle.

Allowed values:SMALLMEDIUMLARGEXLARGEWIDELOADOVERSIZEOTHER

Example:MEDIUM

shipperRequestedPickupDatestring(date-time)

The date the shipper would like the vehicle to be picked up, in UTC/ISO 8601 format.

Example:2025-07-15T00:00:00.000Z

shipperRequestedDropOffDatestring(date-time)

The date the shipper would like the vehicle to be picked up, in UTC/ISO 8601 format.

Example:2025-08-15T00:00:00.000Z

colorstring

The color of the vehicle.

Example:Red

isInOperableboolean

Indicates whether the vehicle is inoperable.

isEnclosedboolean

Indicates whether the transport is enclosed.

Default:false

Example:true

yearinteger

The 4 digit year of the vehicle. Required if vin is not supplied.

Example:2022

makestring

The manufacturer’s make of the vehicle. Required if vin is not supplied.

Example:Chevrolet

modelstring

The manufacturer’s model of the vehicle. Required if vin is not supplied.

Example:Spark

subModelstring

The manufacturer’s sub-model of the vehicle.

Example:ACTIV

weightinteger(int32)

The weight of the vehicle.

Example:2246

weightUnitsstring

The units of weight.

Default:LBS

Example:lbs

inspectionTypestring

The type of inspection the vehicle requires.

Allowed values:STANDARDART

Example:ART

isDriveAwayboolean

Indicates whether the vehicle is a drive-away.

Default:false

Example:true

licensePlatestring

The license plate of the vehicle.

Example:B314PIE

licensePlateStatestring

The two-letter state abbreviation of the vehicle’s license plate.

Example:CA

lotNumberstring

The lot number of the vehicle.

Example:LOT789

additionalInformationstring

Additional information.

Example:The vehicle is in the back of the lot behind the big tree.

pickUpDateTypestring

The type of pick up date.

Allowed values:ESTIMATEDEXACTLYNO_EARLIER_THANNO_LATER_THAN

Default:ESTIMATED

Example:NO_EARLIER_THAN

dropOffDateTypestring

The type of delivery date.

Allowed values:ESTIMATEDEXACTLYNO_EARLIER_THANNO_LATER_THAN

Default:ESTIMATED

Example:ESTIMATED

tariffnumber(double)

The tariff on the vehicle.

Example:1030.5

trimstring

The manufacturer’s trim of the vehicle.

Example:LS

fuelTypestring

The type of fuel.

Example:Gas

heightinteger

The height of the vehicle.

Example:58

widthinteger

The width of the vehicle.

Example:62

lengthinteger

The length of the vehicle.

Example:143

lengthUnitsstring

The units of length.

Default:inches

Example:inches

widthUnitsstring

The units of width.

Default:inches

Example:62

heightUnitsstring

The units of height.

Default:inches

Example:inches

requiresInspectionboolean

Indicates the shipper requests for the carrier to use the Central Dispatch Mobile App to perform vehicle inspection at pickup and delivery. If true, the carrier will be asked to acknowledge the request before accepting the load.

Default:false

Example:true

inspectionAcknowledgedboolean

Indicates whether the require inspection requirement was acknoowledged.

Default:false

Example:true

Example

VehicleResponse

object

Dispatch vehicle details.

vehicleDetailsarray[object]

Details of a vehicle.

Show Child Parameters
dispatchVehicleDateChangesarray[object]

Details of a vehicle date change.

Show Child Parameters
dispatchVehicleStatusChangesarray[object]

Details of a vehicle status change.

Show Child Parameters
shipmentDescriptionVehicleIdstring(uuid)

The ID of the shipment description.

Example:b331c130-e89b-12d3-a456-426614174000

pickupStopIdstring(uuid)

The system assigned UUID of the stop.

Example:4e2efc84-6add-435c-9f12-8b19e3e5ba21

dropoffStopIdstring(uuid)

The stop number (the sequential number of the stop along the route) of the delivery location.

Example:fa110000-e89b-12d3-a456-426614174000

isEnclosedboolean

Indicates whether the transport is enclosed.

Example:true

createdDateUtcstring

The date and time the dispatch was created, in UTC/ISO 8601 format.

Example:2024-10-31T00:00:00Z

lastUpdatedDateUtcstring

The date and time the dispatch was last updated, in UTC/ISO 8601 format.

Example:2024-10-15T00:00:00Z

lastUpdatedBystring

The Central Dispatch user ID of the user who last updated the dispatch.

Example:d71b5750-e89b-12d3-a456-426614174000

dispatchVehicleIdstring(uuid)

The ID of the vehicle.

Example:b331c130-e89b-12d3-a456-426614174000

dispatchIdstring(uuid)

The ID of the dispatch.

Example:d159acc0-e89b-12d3-a456-426614174000

externalIdstring

An identifier managed by the user. Shippers can use this field to map Central Dispatch dispatch ID to a record (e.g. order, shipment, dispatch) in their local TMS.

Example:RND10 CHEV

vehicleIdstring(uuid)

The ID of the vehicle.

Example:b331c130-e89b-12d3-a456-426614174000

vinstring

The vehicle identification number (VIN).

Example:KL8CH6SA6NC001234

estimatedPickupDatestring

The estimated pick up date, in UTC/ISO 8601 format.

Example:2025-11-05T00:00:00.000Z

estimatedDropOffDatestring

The estimated delivery date, in UTC/ISO 8601 format.

Example:2025-07-15T00:00:00.000Z

actualPickupDatestring

The actual pick up date and time, in UTC/ISO 8601 format.

Example:2025-11-05T00:00:00.000Z

actualDropOffDatestring

The actual delivery date and time, in UTC/ISO 8601 format.

Example:2025-08-15T00:00:00.000Z

carrierEstimatedPickupDatestring

The date the carrier estimates the vehicle will be picked up, in UTC/ISO 8601 format.

Example:2025-11-05T00:00:00.000Z

carrierEstimatedDropOffDatestring

The date the carrier estimates the vehicle will be dropped off, in UTC/ISO 8601 format.

Example:2025-07-15T00:00:00.000Z

shipperRequestedPickupDatestring

The date the shipper would like the vehicle to be picked up, in UTC/ISO 8601 format.

Example:2025-11-05T00:00:00.000Z

shipperRequestedDropOffDatestring

The date the shipper would like the vehicle to be dropped off, in UTC/ISO 8601 format.

Example:2025-07-15T00:00:00.000Z

statusstring

The status of the vehicle.

Example:PENDING_PICKUP

carrierPricenumber(double)

The price to be paid to the carrier for completing the delivery of this vehicle (reference only).

carrierPriceCurrencystring

The currency of carrierPrice.

Example:USD

distancenumber(double)

The total travel distance.

Example:267

distanceUnitsstring

The units of distance.

Example:MILES

externalVehicleIdstring

A vehicle identifier managed by the user. Shippers can use this field to map Central Dispatch dispatch ID to a vehicle record in their local TMS.

Example:EXT123456

needActionboolean

Indicates whether action is needed.

Default:false

inspectionTypestring

The type of inspection the vehicle requires.

Example:ART

isDriveAwayboolean

Indicates whether the vehicle is a drive-away.

Default:false

Example:true

isOversizeboolean

Indicates whether the load is oversized.

Default:false

isWideloadboolean

Indicates whether the load is a wide load.

Default:false

pickUpDateTypestring

The type of pick up date.

Example:NO_EARLIER_THAN

dropOffDateTypestring

The type of delivery date.

Example:ESTIMATED

requiresInspectionboolean

Indicates the shipper requests for the carrier to use the Central Dispatch Mobile App to perform vehicle inspection at pickup and delivery. If true, the carrier will be asked to acknowledge the request before accepting the load.

Default:false

Example:true

inspectionAcknowledgedboolean

Indicates whether the require inspection requirement was acknoowledged.

Default:false

Example:true

Example

VehicleStatusChangeResponse

object

Details of a vehicle status change.

dateUtcstring(date-time)

The date and time of the status change, in UTC/ISO 8601 format.

Example:2024-10-31T00:00:00Z

statusstring

The status of the vehicle.

Example:PENDING_PICKUP

Example