Fulfillment API

StopResponse

object

Details of a stop.

shipmentDescriptionIdstring

The ID of the shipment description.

Example:519e0000-e89b-12d3-a456-426614174000

hrefstring

The URL used to query the current collection of the resource.

Example:https://fulfillment-api.centraldispatch.com/api/fulfillments/id/d159acc0-e89b-12d3-a456-426614174000

stopIdstring(uuid)

The system assigned UUID of the stop.

Example:9b6e0fad-8722-4da1-907c-f9522c04ef12

sequenceIdstring

The sequential number of the stop along the route e.g. 1 is the pick up stop and 2 is the delivery stop.

Example:1

stopTypestring

The facility type of the stop.

Allowed values:OTHERAIRPORT_RENTAL_CENTERAUCTIONAUCTION_SATELLITE_LOTCOMMERCIAL_BUSINESSCORPORATE_OFFICE_PLANTCROSS_DOCK_OR_SATELLITE_STAGING_LOTDEALERIMPOUNDMARSHALLING_YARDMILITARY_BASEMOBILE_AUCTIONPORTRAIL_YARDRECON_FACILITYRENTAL_CAR_RETAIL_SITEREPORESIDENCESERVICE_CENTERTERMINAL

Example:DEALER

stopTypeDescriptionstring

The name of the stop.

Example:Dealership in the heart of the city.

locationNamestring

The name of the stop.

Example:ABC Cars lot

externalLocationIdstring

A location identifier managed by the user.

Example:Loc123

addressstring

The street address.

Example:345 W Elm St.

address2string

Additional street address line.

Example:2nd Floor

citystring

The city.

Example:Anaheim

statestring

The state.

Example:CA

zipCodestring

The ZIP code. Must be a valid United States ZIP code or Canadian postal code.

Example:92802

countrystring

The country code. US or CA.

Example:US

phonestring

The primary phone number of the contact.

Example:949-555-0101

phone2string

An additional phone number of the contact.

Example:949-555-2434

phone3string

An additional phone number of the contact.

Example:949-555-3545

siteIdstring

The ID of the site.

Example:ABC

contactNamestring

The name of the contact.

Example:Mickey Smith

contactPhonestring

The primary phone number of the contact.

Example:949-555-0101

contactCellPhonestring

The cell phone number of the contact.

Example:949-555-1212

contactEmailstring

The email address of the contact. Must be a valid email address format.

Example:mickey@snoogle.com

isTWICboolean

Indicates whether the stop requires driver to have a Transportation Worker Identification Credential (TWIC). A TWIC is a credential required by the Maritime Transportation Security Act for carriers to access some locations. If you are not sure if a TWIC is needed, please contact the location.

Example:true

latitudestring

The latitude of the location.

Example:33.81228788622535

longitudestring

The longitude of the location.

Example:-117.91836265987132

buyerNumberstring

The buyer reference number.

Example:12345

Example

UpdateDispatchDatesRequest

object

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
Example

UpdateDispatchDatesVehicleDateChangeRequest

object

Details of vehicle dates.

dateTypestring

The type of date.

Allowed values:ESTIMATED_PICKUPACTUAL_PICKUPESTIMATED_DROPOFFACTUAL_DROPOFFSHIPPER_REQUESTED_PICKUPSHIPPER_REQUESTED_DROPOFFCARRIER_ESTIMATED_PICKUPCARRIER_ESTIMATED_DROPOFF

Example:ESTIMATED_PICKUP

dateValuestring(date-time)

The date, in UTC/ISO 8601 format.

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

dateChangeReasonIdstring(uuid)

The ID of the date change reason. This value can be retrieved using the ‘Get Date Change Reasons’ endpoint. Required for carrier.

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

notesstring

Additional information.

Example:Shipper needs more time to prepare the vehicle.

Example

UpdateDispatchDatesVehiclesRequest

object

Details of dispatch vehicle dates.

dispatchVehicleIdstring(uuid)

The ID of the vehicle.

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

dateChangesarray[object]

Details of vehicle dates.

Show Child Parameters
Example

UpdateDispatchRequest

object

Details of a dispatch.

dispatchIdstring(uuid)

The ID of the dispatch.

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

externalOrderIdstring

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

Example:ORD-2023-0001

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

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[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

The currency of balanceAmount.

Default:USD

Example:USD

balancePaymentMethodstring

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

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

Allowed values:PICKUPDELIVERYRECEIVING_SIGNED_BOL

Example:PICKUP

balancePaymentTimestring

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

The currency of codAmount.

Default:USD

Example:USD

codPaymentLocationstring

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

Allowed values:PICKUPDELIVERY

Example:PICKUP

codPaymentMethodstring

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

Allowed values:CHECKCASH_CERTIFIED_FUNDS

Example:CASH_CERTIFIED_FUNDS

instructionsstring

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

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

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

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

Example