Fulfillment API

SearchRequest

object

Details of search fields.

dispatchStatusarray[string]

A collection of: Dispatch statuses e.g. NEW, PENDING_DELIVERY, DELIVERED, PAID, REJECTED, CANCELED.

pickUpCityarray[string]

A collection of: The pick up city.

pickUpStatearray[string]

A collection of: The pick up state.

pickUpZiparray[string]

A collection of: The pick up ZIP code. Must be a valid United States ZIP code or Canadian postal code.

deliveryCityarray[string]

A collection of: The delivery city.

deliveryStatearray[string]

A collection of: The delivery state.

deliveryZiparray[string]

A collection of: The delivery ZIP code.

externalIdarray[string]

A collection of: 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.

dispatchIDstring

A collection of: The ID of the dispatch.

vinarray[string]

A collection of: The vehicle identification number (VIN).

driverIdarray[string]

A collection of: The Central Dispatch user ID of the driver.

shipperCompanyNamearray[string]

A collection of: The shipper’s company name.

shipperOrderIdarray[string]

A collection of: The ID of the shipper order.

marketPlaceIdsarray[string]

A collection of: The ID of the Central Dispatch Marketplace. There are three types of Marketplaces:

  • Public: The public Marketplace ID is 10000.
  • Test: Test Marketplace IDs will be provided to you by Central Dispatch.
  • Private: Private Marketplace IDs will be provided to you by Central Dispatch, if necessary.
externalCompanyIdsarray[string]

A collection of: The ID of the Central Dispatch customer who is shipping the vehicle.

externalCompanyNamesarray[string]

A collection of: The external company name.

externalVehicleIdsarray[string]

A collection of: 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.

loadIdarray[string]

A collection of: The load number.

carrierNamearray[string]

A collection of: The carrier name.

carrierIdarray[string]

A collection of: The ID of the Central Dispatch customer chosen by the shipper to move cars in the dispatch.

actualPickUpDateTimestring(date-time)

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

actualDropOffDateTimestring(date-time)

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

estimatedPickUpDateTimestring(date-time)

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

estimatedDropOffDateTimestring(date-time)

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

dispatchDateobject

Search dispatch date request.

Show Child Parameters
listingIdsobject

Search listing IDs information.

Show Child Parameters
dispatchIdsobject

Search dispatch IDs information.

Show Child Parameters
driverIdsobject

Driver IDs search.

Show Child Parameters
isCarrierArchivedboolean

Indicates if the carrier is archived.

isShipperArchivedboolean

Indicates if the shipper is archived.

Example

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