Fulfillment API

SortRequest

object

Details of search sort.

namestring

The name of the field to sort by.

Example:actualPickUpDateTime

directionstring

The direction of the sort. Values: ASCENDING, DESCENDING.

Example:ASCENDING

Example

StatusChangeResponse

object

Details of a status change.

submittedByUserNamestring

The Central Dispatch username of the person who submitted the status change.

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

dispatchStatusChangeIdstring(uuid)

The ID of the dispatch status change.

Example:157a16f0-503d-4256-ba60-a4876e8eb9bb

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 dispatch.

Example:PENDING_PICKUP

cancellationReasonIdstring

The ID of the cancellation reason.

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

notesstring

Additional notes regarding the status change.

Example:Weather delay.

submittedPartystring

The party that submitted the status change e.g. SHIPPER or CARRIER.

Example:SHIPPER

submittedBystring

The Central Dispatch user ID of the user who submitted the status change.

Example:3ca6e1c2-98fb-4b4e-bfd8-ffaec58fb347

Example

StopRequest

object

Details of a stop.

stopNumberinteger(int32)

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

namestring

The name of the stop.

Example:ABC Cars lot

addressobject

Details of an address.

Show Child Parameters
contactobject

Details of a contact.

Show Child Parameters
externalLocationIdstring

A location identifier managed by the user.

Example:Loc123

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.

Default:false

Example:true

siteIdstring

The ID of the site.

Example:ABC

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

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