Search
K
Fulfillment API

Update Dispatch

Update an existing dispatch.

📝 Important Notes

  • Every desired property must be sent, null properties will be deleted.
  • The If-Match header is required and its value can be found in the ETag response header of the resource’s GET by ID endpoint.
  • The ID of the resource is returned in resource’s create endpoint. The response will contain a Location header that contains the fully qualified URL of the newly created resource. The final segment of the URL will be the ID of the resource.
post
https://fulfillment-api.centraldispatch.com/api/fulfillments/update

Headers

If-Matchintegerrequired

This is a required field to ensure the update is being completed on an item that has not changed since it was last read. The value of this field will be the value of the ETag header that was received on the preceding get call.

Example:8675309

Content-Typestringrequired

The major version of the API to make a request against. This is a custom MIME type that contains vnd.coxauto.v[#]+. For example, to request a resource from version 1.x.x of an API, the Content-Type header should be set to application/vnd.coxauto.v1+json.

Example:application/vnd.coxauto.v1+json

Body

application/json

UpdateDispatchRequest

UpdateDispatchRequest

Details of a dispatch.

dispatchIdstring(uuid)

The ID of the dispatch.

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

externalOrderIdstring | null

The identifier of the order that created the dispatch in the shipper system managed by the user.

Example:ORD-2023-0001

externalIdstring | null

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

priceobject

Details of the dispatch price.

Show Child Parameters
stopsarray[object]

Details of a stop.

Show Child Parameters
vehiclesarray[object]

Details of a vehicle.

Show Child Parameters
additionalInformationarray | null[object]

Details of additional information.

Show Child Parameters
balanceAmountnumber(double)

The balance amount that will be due after the COD/COP payment is applied.

>= 0

Example:300

balanceAmountCurrencystring | null

The currency of balanceAmount.

Default:USD

Example:USD

balancePaymentMethodstring | null

The payment method with which the balance due payment will be paid. Required if balanceAmount is greater than 0.

Allowed values:CASHCERTIFIED_FUNDSCOMPANY_CHECKCOMCHEKTCH

Example:CASH

balancePaymentTermsBeginOnstring | null

The terms for beginning balance payment. Required if balanceAmount is greater than 0.

Allowed values:PICKUPDELIVERYRECEIVING_SIGNED_BOL

Example:PICKUP

balancePaymentTimestring | null

The time frame when the balance payment is due. Required if balanceAmount is greater than 0.

Allowed values:IMMEDIATELYTWO_BUSINESS_DAYS_QUICK_PAYFIVE_BUSINESS_DAYSTEN_BUSINESS_DAYSFIFTEEN_BUSINESS_DAYSTHIRTY_BUSINESS_DAYS

Example:IMMEDIATELY

codAmountnumber(double)

The cash on delivery (COD) or cash on pick up (COP) amount due.

>= 0

Example:200

codAmountCurrencystring | null

The currency of codAmount.

Default:USD

Example:USD

codPaymentLocationstring | null

The location that COD/COP payment is due. Required if codAmount is greater than 0.

Allowed values:PICKUPDELIVERY

Example:PICKUP

codPaymentMethodstring | null

The method for the COD/COP payment. Required if codAmount is greater than 0.

Allowed values:CHECKCASH_CERTIFIED_FUNDS

Example:CASH_CERTIFIED_FUNDS

instructionsstring | null

Displayed in Central Dispatch website/app as “Load-Specific Terms”, these are provisions added to a contract that specify extra obligations, rights, or conditions beyond the standard terms.
Real Life Example: Charging cables need to be picked up with vehicles and if left behind a $200 fee will be applied.
Rules: This information will be visible only to the assigned carrier after the load is dispatched, and it will no longer be editable at that point.
Note: The original instructions value must be sent in any update request. If a different value is provided, the update will be rejected with status code 422 Unprocessable Entity.

Example:Charging cables need to be picked up with vehicles and if left behind a $200 fee will be applied.

preDispatchNotesstring | null

Provides general preparation instructions for shipments. This should not contain sensitive data as it is made available prior to acceptance of terms by a carrier.
Rules: This information will always be visible to carriers, and it will no longer be editable once the load is dispatched.
Note: The original preDispatchNotes value must be sent in any update request. If a different value is provided, the update will be rejected with status code 422 Unprocessable Entity.

Example:In order to pick up the keys you will have to walk through a lot with a big dog that protects it, he's chained but will bark at you.

transportationReleaseNotesstring | null

Displayed in Central Dispatch website/app as “Transport Special Instructions”, these are specific guidelines or details for the safe and efficient pick up, delivery, or transportation of a load. This may contain sensitive data and is not available prior to acceptance of terms by a carrier.
Rules: This information is visible only to the assigned carrier after the load is dispatched and remains editable at any time.

Example:You will need special clearance to get in the lot. Call Jean at 303-999-1212.

requiresDriverVerificationAtPickUpboolean | null

Indicates if the driver verification process is required. A driver must be assigned to the load before delivery. Information will be emailed to the contact physically present at the pickup location for use in verifying the driver’s identification. The Central Dispatch Mobile App must be used to perform the pickup and delivery inspection. (Only currently applicable to select private Marketplaces).

Default:false

Example:true

Response

No Content. Successful request.

post/api/fulfillments/update

Body

{ "dispatchId": "d159acc0-e89b-12d3-a456-426614174000", "externalId": "RND10 CHEV", "externalOrderId": "ORD-2023-0001", "price": { "totalPrice": 500, "priceUnits": "USD" }, "codAmount": 200, "codAmountCurrency": "USD", "codPaymentMethod": "CASH_CERTIFIED_FUNDS", "codPaymentLocation": "PICKUP", "balanceAmount": 300, "balanceAmountCurrency": "USD", "balancePaymentTime": "IMMEDIATELY", "balancePaymentTermsBeginOn": "PICKUP", "balancePaymentMethod": "CASH", "preDispatchNotes": "In order to pick up the keys you will have to walk through a lot with a big dog that protects it, he's chained but will bark at you.", "transportationReleaseNotes": "You will need special clearance to get in the lot. Call Jean at 303-999-1212.", "stops": [ { "stopNumber": 1, "stopType": "DEALER", "name": "ABC Cars lot", "address": { "address1": "345 W Elm St.", "address2": "2nd Floor", "city": "Anaheim", "state": "CA", "zipCode": "92802", "countryCode": "US" }, "contact": { "name": "Mickey Smith", "phone": "949-555-0101", "phone1": "949-555-1323", "phone2": "949-555-2434", "phone3": "949-555-3545", "cellPhone": "949-555-1212", "email": "mickey@snoogle.com" }, "externalLocationId": "Loc123", "isTWIC": true, "siteId": "ABC", "latitude": "33.81228788622535", "longitude": "-117.91836265987132", "buyerNumber": "12345" }, { "stopNumber": 2, "stopType": "COMMERCIAL_BUSINESS", "name": "XYZ Inc.", "address": { "address1": "255 Sands Ave.", "city": "Las Vegas", "state": "NV", "zipCode": "89169", "countryCode": "US" }, "contact": { "name": "Dean Vega", "phone": "702-555-0101", "phone2": "702-555-0101", "cellPhone": "702-555-1212", "email": "dvega@doogle.com" }, "externalLocationId": "Loc777", "isTWIC": true, "siteId": "Spere", "latitude": "36.121343020081525", "longitude": "-115.16195281104913", "buyerNumber": "9876" } ], "vehicles": [ { "vehicleAttributes": [ { "type": "damage", "name": "hasKeys", "value": false } ], "vehicleId": "b331c130-e89b-12d3-a456-426614174000", "externalVehicleId": "EXT123456", "vin": "KL8CH6SA6NC001234", "distance": 267, "distanceUnits": "MILES", "pickUpLocationId": 1, "dropOffLocationId": 2, "carrierPrice": 500, "carrierPriceUnits": "USD", "type": "CAR", "size": "MEDIUM", "shipperRequestedPickupDate": "2025-09-30T00:00:00.000Z", "shipperRequestedDropOffDate": "2025-10-15T00:00:00.000Z", "color": "Red", "isInOperable": false, "isEnclosed": true, "year": 2022, "make": "Chevrolet", "model": "Spark", "subModel": "ACTIV", "weight": 2246, "weightUnits": "lbs", "inspectionType": "ART", "isDriveAway": false, "licensePlate": "B314PIE", "licensePlateState": "CA", "lotNumber": "LOT789", "additionalInformation": "The vehicle is in the back of the lot behind the big tree.", "pickUpDateType": "NO_EARLIER_THAN", "dropOffDateType": "ESTIMATED" } ], "additionalInformation": [ { "name": "1d1d1d1d-e89b-12d3-a456-426614174000", "value": "The number one" } ] }
 

Update Dispatch Dates

Update the pick up and/or delivery dates of an existing dispatch.

put
https://fulfillment-api.centraldispatch.com/api/fulfillments/id/{dispatchId}/dates

Path Parameters

dispatchIdstring(uuid)required

The ID of the dispatch.

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

Headers

If-Matchintegerrequired

This is a required field to ensure the update is being completed on an item that has not changed since it was last read. The value of this field will be the value of the ETag header that was received on the preceding get call.

Example:8675309

Content-Typestringrequired

The major version of the API to make a request against. This is a custom MIME type that contains vnd.coxauto.v[#]+. For example, to request a resource from version 1.x.x of an API, the Content-Type header should be set to application/vnd.coxauto.v1+json.

Example:application/vnd.coxauto.v1+json

Body

application/json

UpdateDispatchDatesRequest

UpdateDispatchDatesRequest

Details of dispatch vehicle date item.

dispatchIdstring(uuid)

The ID of the dispatch.

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

dispatchVehiclesarray[object]

Details of dispatch vehicle dates.

Show Child Parameters

Response

Accepted. Successful request.

put/api/fulfillments/id/{dispatchId}/dates

Body

{ "dispatchId": "d159acc0-e89b-12d3-a456-426614174000", "etag": 1234567, "dispatchVehicles": [ { "dispatchVehicleId": "b331c130-e89b-12d3-a456-426614174000", "dateChanges": [ { "dateType": "ESTIMATED_PICKUP", "dateValue": "2025-11-05T00:00:00.000Z", "dateChangeReasonId": "da1e0000-e89b-12d3-a456-426614174000", "notes": "Weather delay." } ] } ] }
 

Respond to Dispatch

A carrier can accept or decline a load that has been assigned to them by the shipper.

👥 Customer Type

  • Carrier

📝 Important Notes

  • May only be used by the assigned carrier or a broker with the carrier profile that is assigned to.
  • Only dispatches with a status of NOT_SIGNED will be processed.
post
https://fulfillment-api.centraldispatch.com/api/fulfillments/id/{dispatchId}/respond

Path Parameters

dispatchIdstring(uuid)required

The ID of the dispatch to respond to.

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

Headers

If-Matchintegerrequired

This is a required field to ensure the update is being completed on an item that has not changed since it was last read. The value of this field will be the value of the ETag header that was received on the preceding get call.

Example:8675309

Content-Typestringrequired

The major version of the API to make a request against. This is a custom MIME type that contains vnd.coxauto.v[#]+. For example, to request a resource from version 1.x.x of an API, the Content-Type header should be set to application/vnd.coxauto.v1+json.

Example:application/vnd.coxauto.v1+json

Body

application/json

RespondToDispatchRequest

RespondToDispatchRequest

Details of the respond request.

acceptboolean

Indicates whether the dispatch should be accepted or declined.

Example:true

inspectionAcknowledgedboolean

Indicates whether the require inspection requirement was acknoowledged.

Default:false

Example:true

carrierEstimatedPickupDatestring | null(date-time)

The date the carrier estimates the vehicle will be picked up, in UTC/ISO 8601 format. Only the date portion of the value passed will be saved.

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

carrierEstimatedDeliveryDatestring | null(date-time)

The type of delivery date. Only the date portion of the value passed will be saved.

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

Response

Accepted. Successful request.

post/api/fulfillments/id/{dispatchId}/respond

Body

{ "accept": true }
 

Assign Driver

Assign a driver to a load or unassign a driver from the load.

👥 Customer Type

  • Carrier

📝 Important Notes

  • May only be used by the assigned carrier or a broker with the carrier profile that is assigned to.
patch
https://fulfillment-api.centraldispatch.com/api/fulfillments/id/{dispatchId}/drivers

Path Parameters

dispatchIdstring(uuid)required

The ID of the dispatch.

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

Headers

If-Matchintegerrequired

This is a required field to ensure the update is being completed on an item that has not changed since it was last read. The value of this field will be the value of the ETag header that was received on the preceding get call.

Example:8675309

Content-Typestringrequired

The major version of the API to make a request against. This is a custom MIME type that contains vnd.coxauto.v[#]+. For example, to request a resource from version 1.x.x of an API, the Content-Type header should be set to application/vnd.coxauto.v1+json.

Example:application/vnd.coxauto.v1+json

Body

application/json

AssignDriverRequest collection

Details of driver patch operation.

opstring

The operation to be performed. Values: ADD, REMOVE.

Example:ADD

pathstring

The path to the property to be modified.

Example:/drivers/drivers/-

valuesarray[object]

Details of driver patch operation.

Show Child Parameters

Response

No Content. Successful request.

patch/api/fulfillments/id/{dispatchId}/drivers

Body

[ { "op": "ADD", "path": "/drivers/drivers/-", "values": [ { "driverId": "3ca6e1c2-98fb-4b4e-bfd8-ffaec58fb347" } ] } ]
 

Cancel Dispatch

Cancel a dispatch that has not been delivered.

📝 Important Notes

  • A dispatch with a status of DELIVERED cannot be canceled.
  • A dispatch with a status of PENDING_DELIVERY can be canceled if the postPickupCancelOverride value is true.
post
https://fulfillment-api.centraldispatch.com/api/fulfillments/cancel

Headers

If-Matchintegerrequired

This is a required field to ensure the update is being completed on an item that has not changed since it was last read. The value of this field will be the value of the ETag header that was received on the preceding get call.

Example:8675309

Content-Typestringrequired

The major version of the API to make a request against. This is a custom MIME type that contains vnd.coxauto.v[#]+. For example, to request a resource from version 1.x.x of an API, the Content-Type header should be set to application/vnd.coxauto.v1+json.

Example:application/vnd.coxauto.v1+json

Body

application/json

CancelDispatchRequest

CancelDispatchRequest

Details of a dispatch cancellation.

dispatchIdstring(uuid)

The ID of the dispatch.

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

cancellationReasonIdstring(uuid)

The ID of the cancellation reason. This value can be retrieved using the ‘Get Cancellation Reasons’ endpoint. Required if caller is a carrier.

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

notesstring | null

Additional notes regarding the cancellation.

Example:Weather delay.

postPickupCancelOverrideboolean

Indicates if a cancellation override after vehicle pick up is allowed.

Default:false

Example:true

Response

No Content. Successful request.

post/api/fulfillments/cancel

Body

{ "dispatchId": "d159acc0-e89b-12d3-a456-426614174000", "notes": "Weather delay.", "postPickupCancelOverride": true }